New Relic の監視(パブリック プレビュー)
Instana を使用すると、ホストや仮想マシンなどの IT インフラストラクチャを監視するための可観測性ツール群である New Relic を監視できます。
Instana ホストエージェントをインストールすると、 Instana の New Relic センサーが自動的にインストールされます。 「 New Relic 」センサーの 「Configuring the sensor」セクションに記載されている手順に従ってセンサーを設定すると、 Instana のUIで、 New Relic によって監視されているホストおよびそれに関連するメトリクスやイベントを確認できるようになります。
補足情報
サポートされる OS
New Relicセンサーの対応OSは、ホストエージェントの要件と一致しています。これについては、各ホストエージェントの「対応OS」セクションで確認できます。例: Unix の対応OS。
New Relic センサーの設定
接続先の New Relic インスタンスのエンドポイントと API キーを使用して、 New Relic センサーを設定する必要があります。 以下のコード・スニペットは、エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yamlで構成する必要があるフィールドを示しています。
com.instana.plugin.newrelic:
enabled: true
endpoint: "https://api.newrelic.com/graphql"
api_user_key: redacted
accountID: redacted
poll_rate: 30
以下の表に、サポートされる構成オプションを示します。
| 名前 | タイプ | 必須 | Default | 説明 |
|---|---|---|---|---|
enabled |
ブール値 | いいえ | いいえ | この変数は、センサーが有効になっているかどうかを検証します。 |
endpoint |
ストリング | はい | NA | New Relic センサーが接続する NerdGraph エンドポイント。 |
accountID |
整数 | はい | NA | New Relic のアカウントID。 |
api_user_key |
ストリング | はい | NA | API 鍵 エンドポイントにアクセスするために使用されるものです。 New Relic センサーは、「User」タイプの API キーを使用します。 |
poll_rate |
整数 | いいえ | 30時間まで | メトリック照会の間隔 (秒数)。 この時間は、エンドポイントによって課されるポーリング・レート制限を考慮して調整する必要がある場合があります。 |
target_zone |
ストリング | いいえ | NA | 「 Instana 」のインフラストラクチャマップ上に、 New Relic で監視されているホストが表示されるジェネリックゾーンの名前。 指定しない場合、ホストは Undefined Zoneに表示されます。 |
New Relic エンドポイント
Instana New Relic センサーは、 NerdGraph API を使用して、 New Relic が監視しているホストに関する情報を収集します。 「 API 」エンドポイントは、 New Relic と通信するために必要です。 ホスト名は、 New Relic インスタンスがデプロイされているリージョンによって異なりますが、エンドポイントには必ず という /graphql 接尾辞を含める必要があります。
New Relic API キー
New Relic ( API )で認証を行うには、 API キーが必要です。 New Relic API のいくつかの異なる種類のキーを使用します。 New Relic センサーには、「User」タイプの API キーが必要です。 New Relic API キーの作成方法の詳細については、 New Relic のドキュメントを参照してください。
メトリックの表示
メトリックを表示するには、以下のステップを実行します。
- Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 を選択します。
- 「 New Relic 」で監視されているホストをクリックします。
すると、収集されたすべての New Relic メトリクスが表示されたリモートホストのダッシュボードを確認できます。
構成データ
- OS (タイプおよび名前)
- CPU 数
- メモリーの合計
- ホスト名および FQDN
- ファイル・システム (名前および容量)
- ネットワーク・インターフェース (名前、MAC、および IP アドレス)
パフォーマンス・メトリック
- CPU 使用率 (%)
- CPU 負荷 (Linux のみ)
- 使用メモリー
- 使用スワップ (Linux のみ)
- ファイル・システム (使用率、読み取りまたは書き込み、および i ノード使用率)
- ネットワーク RX および TX バイト
イベントの表示
New Relic いくつかの異なるイベントタイプを追跡します。 InfrastructureEvent 型のイベントは、変更として Instana にインポートされます。 変更を表示するには、以下の手順を実行します。
- Instana のUIにあるナビゲーションメニューから、 「イベント」 を選択します。
- 変更されていないイベントをフィルターで除外するには、 「変更」 タブをクリックします。
- New Relic からインポートされた変更をフィルタリングするには、検索ボックスに次のクエリを入力してください:
entity.remote.host.source:Newrelic
すると、 New Relic からインポートされたインフラストラクチャ・イベントの一覧が表示されます。 New Relic インフラストラクチャ関連のイベントは、システムやインベントリの状態の変化を追跡するものであり、そのため、期間を指定せずに「変更」として登録されます。
トラブルシューティング
エージェントの監視に関する問題
New Relic センサーが New Relic サーバーと通信できない場合、エージェントの監視に関する問題が発生します。 この問題は、どの構成パラメーターが正しくない可能性があるかを示しています。 たとえば、センサーが New Relic サーバーから HTTP 401 または 403 エラーを受信した場合、 API キーが正しくないか、有効期限が切れている可能性があります。 以下の構成パラメーターが原因で、エージェント・モニターの問題が発生する可能性があります。
endpointapi_user_key( HTTP 401/403)poll_rate( HTTP 429)
エージェント OutOfMemoryError
多数のホストを監視している New Relic サーバーに接続している場合、 Instana エージェントの JVM ヒープサイズを増やす必要がある可能性があります。 エージェントのログに OutOfMemoryError が見つかった場合は、 Instana エージェントの最大ヒープサイズを増やすことを検討してください。 詳細については、「 環境変数リファレンス 」の 環境変数 JAVA_OPTS を参照してください。