Ruby 対応コンポーネントとバージョン

オンラインで編集する

Instana gem が現在の環境と互換性があるかどうかを確認するには、以下のサポート情報セクションをご確認ください。

Ruby アプリケーションの監視に関する詳細については、 「 Ruby の監視」 を参照してください。

Ruby 対応コンポーネント

Ruby でサポートされるバージョン

オンラインで編集する

次の表は、 Instana gemがサポートする Ruby のバージョンをまとめたものです：

Ruby バージョン Ruby センサーのバージョン
クルービー > = 2.1 および < 2.7 <= 1.209.4
クルービー > = 2.7 および < = 3.3 <= 1.213.3
クルービー >= 3.0 かつ <= 3.4 >= 1.217.1
クルービー >= 3.1 かつ <= 4.0 <= 2.5.1
クルービー >= 3.2 かつ <= 4.0 >= 2.6.0

長期サポート

オンラインで編集する

Ruby の公式な LTS およびサポート終了（EOL）のスケジュールに従います。

注：Ruby のバージョンがサポート終了日を迎えた場合、 Instana ではさらに1年間のサポート期間を提供します。 トラブルを防ぐため、 Ruby のバージョンを定期的に更新してください。

サポートされるフレームワーク

オンラインで編集する

次の表は、 Instana gem がサポートする Ruby フレームワークの一覧です：

フレームワーク サポート・ポリシー バージョン 注
Cuba オンデマンド > = 3.0.0 および < = 4.0.3
ラック 45 日間 >= 1.4.5 かつ <= 3.2.6
レール 45 日間 >= 0.4.0 かつ <= 8.1.3 ActionControllerモジュールおよびActionView モジュ ールのrender_partialメソッドに対するインストルメンテーションがサポートされています。
Rails:: API 45 日間 > = 0.4.0 および < = 0.4.1 Rails:: API がRails にマージされました 5.0.0
Rails LTS オンデマンド >= 2.3 かつ <= 6.1
Roda 45 日間 >= 2.0.0 かつ <= 3.105.0
Sinatra 45 日間 >= 1.1.4 かつ <= 4.2.1

対応しているクライアントとライブラリ

オンラインで編集する
注： トレースの連続性は、 データベースおよびロギングライブラリには適用されません。

次の表は、 Instana gem がサポートする Ruby クライアントライブラリの一覧です：

クライアント サポート・ポリシー バージョン 注
Excon 45 日間 >= 0.21.0 かつ <= 1.5.0
gRPC 45 日間 >= 1.0.1 かつ <= 1.81.1
Net::HTTP 0日 >= 2.1 かつ <= 0.9.1
Rest-クライアント 45 日間 > = 1.6.0 および < = 2.1.0
続編 45 日間 >= 5.60 かつ <= 5.105.0

次の表は、 Instana gem がサポートする Memcache ライブラリの一覧です：

Memcache サポート・ポリシー バージョン
Dalli 45 日間 >= 2.0.0 かつ <= 5.0.5

次の表は、 Instana gem がサポートする Ruby のメッセージングおよびバックグラウンドジョブ処理ライブラリの一覧です：

メッセージングおよびバックグラウンド・ジョブ処理 サポート・ポリシー バージョン
Resque 45 日間 >= 1.22.0 かつ <= 3.0.0
Sidekiq 45 日間 >= 2.12.0 かつ <= 8.1.6
バニー 45 日間 >= 2.23.0 かつ <= 2.24.0

次の表は、 Instana gem がサポートするクエリ言語の一覧です：

照会言語 サポート・ポリシー バージョン
GraphQL 45 日間 >= 1.8.8 かつ <= 2.6.3

サポートされる Web サーバー

オンラインで編集する

Instana gem は、以下の Web サーバーに対応しています：

  • Apache
  • Nginx
  • Passenger
  • Puma
  • Rhebok
  • 細
  • Unicorn

センサー・データ収集

オンラインで編集する

Instana gemは、以下の設定およびメトリクスデータを収集します：

追跡対象の構成 メトリック
Ruby のバージョン GC に費やした時間
ランタイム引数 メモリー使用率
フレームワーク ヒープ・スロット
Gem バンドル スレッド数

トレース

オンラインで編集する

Ruby アプリケーションのトレース機能を有効にすることができます。

トレースのサポート

オンラインで編集する

Instana を使用すると、 Ruby アプリケーションに対して以下のトレース機能を有効にできます：

追跡メモと制限事項

オンラインで編集する

Instana Ruby アプリケーションのトレースを行う際、以下の制限があります：

複数のトレーサーを使ったトレース

オンラインで編集する

Instana と、 New Relic トレーサーや OpenTelemetry などのサードパーティ製トレーサーを併用して、単一の Ruby アプリケーションをトレースすることはサポートされていません。

競合するジェムを有効にしないようにしてください

オンラインで編集する

Instana （ AutoTrace ）のWebhookや、 Instana （ Ruby ）のトレーサーを使用する場合、対象アプリケーションに対してそれらの依存関係となるGemを配信する必要があります。 依存関係 gem は、アプリケーションが独自の依存関係を選択した後に配信されます。 したがって、2つの依存関係ツリー（つまり、 Instana Ruby のトレーサーと、 Ruby アプリケーション）の間に重複が存在する可能性があります。 Instana トレーサーは、同じ Ruby gemの複数のバージョンが起動されるのを防ぐため、細心の注意を払って動作します。 アプリケーションは、競合が発生しないように、使用可能なすべての gem またはランダムに選択された gem をアクティブ化しないようにすることで、責任を持って行動する必要があります。 結果として、明示的なアクティベーション・メソッドおよびアクティベーション・副次作用のあるメソッドを無条件で使用することはできません。

以下の方法を条件付きで使用できます。

  • Gem::Specification.activate
  • Gem::Specification.activate_dependencies
  • Gem.activate_bin_path