• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

New Relic Flex:独自のインテグレーションを構築

New Relicは、多くの一般的なサービスやフレームワーク向けのインテグレーションとクイックスタートを提供しています。New Relicをすでに使用しており、インテグレーションの対象外のサービスからデータのレポートを行う場合、次のいくつかの方法で独自のインテグレーションを作成できます。

Flexとは?

New Relic Flexは、アプリケーションに依存しないすべてを兼ね備えたツールで、このツールを使用して広範なサービスからメトリックデータを収集できます。Flexはインフラストラクチャエージェントとバンドルで提供されます。標準プロトコル(HTTP、ファイル、シェル)上のメトリクスを標準形式(JSONやプレーンテキストなど)で公開するアプリケーションをインストゥルメントできます。YAML設定ファイルを作成し、インフラストラクチャエージェントを起動すると、データがNew Relicに報告されます。

Flexは、広範なソースから、New Relicにイベントとメトリックデータを送信できます。簡単なYAML設定ファイルを使用して、HTTP/HTTPSリクエストを実行し、シェルコマンドを実行し、ファイルコンテンツのパースを行えます。また、標準の正規表現を使用して、この入力から収集したデータのカスタマイズと制御も行えます。設定の例をご覧ください。

データの収集とクリーンアップを行った後、New RelicでFlexデータのクエリを行い、カスタムチャートを作成し、そのデータをダッシュボードで使用できます。

要件

Flexには、Linux、Windows、またはKubernetesで実行しているインフラストラクチャエージェントバージョン1.10.7以降(アップデート | バージョンの確認)がバンドルされています。

Flexの動作のしくみ

Flexはインフラストラクチャを使用して、レポートするデータを生成するコマンドを実行します。データのレポートでのFlexのしくみの概要は次のとおりです。

  1. インフラストラクチャエージェントパッケージにある、YAML設定ファイルでレポートするデータを定義します。設定の例をご覧ください:

  2. インフラストラクチャエージェントは、Flexを独自の設定に基づく頻度(デフォルト:30秒ごと)で実行し、New Relicにデータを送信します。

  3. その後データのクエリを行い、そのデータを使用してカスタムチャートを作成し、データをダッシュボードに追加できます。

このドキュメントはインストールの役に立ちましたか?

トラブルシューティング

Flex設定で問題が発生した場合は、まず次に示すトラブルシューティングの基本手順に従ってください。

  • Infrastructureエージェントを使用せずに設定をテストする:次のようなコマンドの<FILE_NAME>の部分を構成ファイルの名前に置き換えて実行すると、構成ファイルを手動でテストし、期待どおりの出力が得られるかどうかを確認できます。
# Linux default path: /opt/newrelic-infra/newrelic-integrations/bin/
./nri-flex -verbose -pretty -config_path /etc/newrelic-infra/integrations.d/<FILE_NAME>
# Windows default path: C:\Program Files\New Relic\newrelic-infra\newrelic-integrations
.\nri-flex.exe -verbose -pretty -config_path "C:\Program Files\New Relic\newrelic-infra\integrations.d\<FILE_NAME>"

これにより、Infrastructureエージェントと統合される、デバッグログとJSONペイロードの出力が得られます。残りのトラブルシューティング手順に進む前に、Flexが意図したとおりにテレメトリーを取得して書式を整えていることを確認してください。Flex設定のテストの詳細については、GitHubリポジトリをご覧ください。

  • dry-runモードでInfrastructureエージェントを使用してテストする:Infrastructureエージェントのdry-runフラグを使用して、Flex設定をテストします。New Relicにレポートするテレメトリが出力に含まれていることを確認します。
  • Infrastructureエージェントを使用してインテグレーションをデバッグする:最後に、Infrastructureエージェントでデバッグログを有効化して、エージェントが意図どおりにテレメトリデータをレポートしていることを確認します。

詳細情報

Flexインテグレーションはインフラストラクチャエージェントに同梱されており、他のオンホストインテグレーションと同様に設定できます。設定オプションの詳細をご覧ください。

GitHubでその他のFlexドキュメントをご覧ください。

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.