• /
  • ログイン
  • 無料アカウント

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

統合ログの推奨事項

New Relic Infrastructure では、オンホストのインテグレーションを作成するための SDK を提供しています。このドキュメントでは、統合ログを生成するための要件とベスト プラクティスについて説明します。

ロギングの要件

どのようなログ・メッセージを作成するか、またどのような情報が問題のデバッグに役立つかは、統合機能の作成者次第です。統合機能がログを生成するための要件は1つだけです。

  • 統合実行ファイルは、標準エラー(stderr)にログを書き込む必要があります。

インフラストラクチャーエージェントは、標準エラーに書き込まれた行をキャプチャし、インフラストラクチャーエージェント自身によって書き込まれた ロギングストリーム にマージします。

サードパーティのログソリューションに依存しないように、Goの統合構築ライブラリでは、一般的なログレベルを備えた シンプルなログパッケージを提供しています。

ここでは、統合ログを生成するための推奨事項を説明します。

  • * デフォルトでは、統合は"静かでなければなりません。" 標準出力に出力されるデータを除けば、ログや診断メッセージはほとんど生成されないはずです。
  • インフラストラクチャエージェントの verbose の設定と同様の冗長ロギングモードを含めることをお勧めします。冗長ロギングを有効または無効にするコマンドラインスイッチを含める(例: -verbose )。
  • 統合が実行されている間に統合をデバッグするには、実行するコマンドラインの一部として定義ファイルに verbose スイッチを含めます。これにより、冗長なログがInfrastructureエージェント自身のログファイルに送信されます。
  • 一般的なデバッグ目的の場合、New Relic では、標準出力の JSON データを人間が読める"pretty-printed" 形式で書き込むフラグを使用することを推奨します (例: --pretty)。なお、"pretty-printed" 形式で書かれた出力は、あなたのデバッグ目的のためだけのものであり、Infrastructure エージェントとは互換性がありません。
  • 統合は、単独で実行できるように作成する必要があります。インテグレーションがInfrastructureエージェントと通信しているかどうか疑わしい場合は、コマンドラインからインテグレーションを実行して、期待通りの出力やログメッセージを生成しているかどうかを確認することができます。

Go言語のロギングパッケージについては、 ロギングパッケージ を参照してください。

問題を作成する
Copyright © 2022 New Relic Inc.