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

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

• インフラストラクチャモニタリングを使用して、軽量のFlexツール（以下で推奨、文書化）を使用できます。完全なインフラストラクチャオンホストインテグレーションを構築するには、Integrations SDKをご覧ください。
• テレメトリ（メトリクス、トレース）モニタリングソリューションには、当社のテレメトリーSDKを使用します。
• 独自のJavaScript UI機能を使用する、カスタムの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設定ファイルでレポートするデータを定義します。設定の例をご覧ください：

   設定の例

   Linuxサーバーの稼働時間をモニターするためのFlex設定の例は次のとおりです。この設定は、flex-uptime.ymlという名前のファイルにあります。この設定は、/etc/newrelic-infra/integrations.d/flex-uptime.ymlにある、インフラストラクチャエージェントのインテグレーション設定セクションにあります。

   integrations:
     - name: nri-flex    
       config:
         name: linuxUptimeIntegration
         apis:
           - name: Uptime
             commands:
               - run: 'cat /proc/uptime'
                 split: horizontal
                 split_by: \s+
                 set_header: [uptimeSeconds,idletimeSeconds]

   コピー

   この設定で行うことについての注：

   • run 実行するコマンドを定義します。
   • name: Uptimeで示される名前には、UptimeSampleと呼ばれるイベントを生成するためのSampleが付けられます。
   • 名前の先頭には、ESXまたはPCFプレフィックスを付けないでください。
   • split_by: \s+は、空白文字に基づきフィールドを分割します。
   • このコマンドは、UptimeSampleイベントに添付された属性を生成します。属性の名前はuptimeSecondsとidletimeSecondsです。

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ドキュメントをご覧ください。

• READMEをご覧ください
• チュートリアル