インフラストラクチャエージェントは、さまざまな方法で構成できます。デフォルトの方法は、 newrelic-infra.yml
ファイルの構成変数を編集することです。
設定ファイルのテンプレートは、 Infrastructure config file template にあります。また、 環境変数 を設定してコンフィグファイルを上書きしたり、 コンフィグ管理ツール (AnsibleやPuppetなど)を使用することもできます。
インフラストラクチャエージェントと連携するオンホスト統合を設定するには、 特定の統合のドキュメント を参照してください。
重要
設定を変更した後は、必ず エージェントを再起動してください 。統合構成の更新にはエージェントの再起動は必要ありません (ホットリロードがサポートされています)。
構成方法と優先順位
インフラストラクチャエージェントを構成するためのデフォルトの方法は、 newrelic-infra.yml
構成ファイルです。コンテナ化された環境に最適な環境変数を設定することで、構成ファイルをオーバーライドできます。
環境変数は、設定ファイルを上書きします。設定ファイルは、エージェントのデフォルト値を上書きします。
各構成方法の詳細な説明は次のとおりです。
構成オプションを調べる
定義、デフォルト、および関連する環境変数を含む、構成できるすべての設定のリストについては、「 インフラストラクチャ構成設定」を参照してください。
設定ファイルの構成
エージェントまたは統合の YAML 構成ファイルを編集する場合:
- YAML フォーマット規則に従います。
- 設定オプションのケーシングを変更しないでください。YAMLのキーは大文字と小文字を区別します。
- インデントレベルを尊重する。すべてのインデントは同じような増分で、通常は2つのスペース文字を使用します。ファイルの同じスタンザ内のデータは、同じレベルのインデントを使用する必要があります。サブスタンザのインデントは、さらにスペース2文字分を追加してください( カスタム属性 および ネットワークインターフェースフィルタ の例を参照)。
- YAML 形式は数値と文字列を区別します。構成値を文字列として解析するには引用符を使用します。
newrelic-infra.yml
のテンプレートは、 インフラストラクチャエージェントリポジトリで利用できます。インフラストラクチャエージェントでファイルを使用する前に、バリデーターを使用して構文が正確であることを確認してください。
設定管理ツール
構成管理ツールを使用してインフラストラクチャ エージェントをインストールおよび管理するには、次のドキュメントを参照してください。
大規模なデプロイのその他のオプションについては、ワークフローの自動化を参照してください。