インフラストラクチャ・モニタリングのためのカスタムLinuxインストール・プロセスでは、インストール・プロセスのすべての側面をカスタマイズし、ファイルシステム上にファイルやフォルダを配置することができます。インストールを完全にコントロールすることができます。
注意
手動インストールのプロセスは監視されていません。手動インストールを選択した場合、異なるファイルを正しいフォルダに配置し、パラメータ化された正しい設定値を提供し、エージェントが実行するためのすべての権限を持っていることを確認する責任があります。
エージェントのインストール
インストールする前に、 互換性と要件を確認してください 。
エージェントパッケージの追加オプション | コメントコメント |
---|---|
トラブルシューティング | インフラストラクチャ エージェント パッケージには、実行中のエージェントのトラブルシューティングに役立つ追加の |
デーモン・プロセス | バージョン1.5.59以降、インフラストラクチャエージェントパッケージには、通常のエージェントデーモンプロセス |
エージェントをインストールするには
パッケージ化されたエージェントファイルをダウンロードするか、次のコマンドを使用して、エージェントの特定のバージョンとそのチェックサムを自動的にフェッチし、ダウンロード後に検証します。
ARCH=amd64
を目的のアーキテクチャ(amd64、386、arm64、arm)に置き換え、V=1.27.4
を最新または特定のバージョンに置き換えます。bash$V=1.27.4 ARCH=amd64; echo "https://download.newrelic.com/infrastructure_agent/binaries/linux/${ARCH}/newrelic-infra_linux_${V}_${ARCH}.tar.gz" | { read url; wget "${url}"{,.sum}; shasum -a 256 --check ${url##*/}.sum; }バージョン
1.27.4
以降、tar.gz
パッケージのGPG署名を提供します。GitHubのインフラエージェントリポジトリで、署名手順と検証手順を確認できます。ファイルを解凍します。
ファイルが以下のような構造で解凍されることを確認してください。
newrelic-infra|-- config_defaults.sh|-- etc| |-- init_scripts| | |-- systemd| | | `-- newrelic-infra.service| | |-- sysv| | | `-- newrelic-infra| | `-- upstart| | `-- newrelic-infra| `-- newrelic-infra| `-- integrations.d|-- installer.sh|-- usr| `-- bin| |-- newrelic-infra| |-- newrelic-infra-ctl| `-- newrelic-infra-service`-- var|-- db| `-- newrelic-infra| |-- custom-integrations| |-- integrations.d| |-- LICENSE.txt| `-- newrelic-integrations|-- log| `-- newrelic-infra`-- run`-- newrelic-infraオプション: 追加のインストール手順.
インストールします。オプションの手順
また、これらの追加手順を実行することもできます。
- 設定ファイルの場所の変更.
- PIDファイルの場所の変更.
- ユーザーとランタイムモードの変更.
- プラグインディレクトリの設定.
- エージェントディレクトリの設定.
- ログファイルの設定.
- エージェントのバイナリの場所を変更する.
このドキュメントはインストールの役に立ちましたか?
サービススクリプトのインストール
サービススクリプトをインストールする前に、システムで使用しているサービスマネージャーを確認する必要があります。
- サポートされているサービスマネージャー(SystemD、SysV、Upstart)のいずれかを使用している場合は、tarballに含まれるサービススクリプトを使用します。
- 当社がサポートしていないサービスマネージャーをご利用の場合は、お客様ご自身でサービススクリプトを作成していただく必要があります。
重要
疑問がある場合は、お使いのLinuxディストリビューションの公式ドキュメントをご確認ください。
重要
サービスマネージャースクリプトをコピーする前に、ユーザ、エージェントのバイナリのパス、またはpidファイルの場所を変更する必要があるかどうかを確認します。これらの変更はすべてサービス・スクリプトに反映させる必要があります。
サポートされているサービスマネージャーのいずれかを使用している場合は、ホスト用のサービススクリプトをインストールします。
サービススクリプトの設定が完了しました。残りのオプションを設定し、手動でサービスを開始します。
設定ファイルの保存場所の変更
インフラストラクチャエージェントには、エージェントの動作を微調整するために、通常はnewrelic-infra.yml
という名前の構成ファイルが含まれています。詳細については、構成ファイルテンプレートおよびエージェントの構成方法を参照してください。
デフォルトでは、エージェントはこれらの場所のいずれかで設定ファイルを検索します。
newrelic-infra.yml
(作業ディレクトリのルートフォルダ)/etc/newrelic-infra.yml
/etc/newrelic-infra/newrelic-infra.yml
別の場所を指定するには、 -config
フラグコマンドラインを使用します。例えば:
$usr/bin/newrelic-infra -config /whatever/path/custom_config_name.yml
この変更を恒久的なものにするには、サービススクリプトを編集します。
pidファイルの保存場所の変更
インフラストラクチャエージェントは、 pid-file
を使用して、エージェントの実行中のインスタンスを識別するために使用されるプロセス識別番号(pid)を保持します。 pid-file
の場所を変更する方法は、エージェントの構成方法によって異なります。
重要
デフォルトでは、エージェントがpid-file
を作成することをお勧めします。必要に応じて場所を編集できます。
pid-file
の場所を変更するには:
ユーザーおよびランタイムモードの変更
Linuxエージェントはデフォルトでroot
として実行されますが、特権が少ないユーザー( PRIVILEGED
およびUNPRIVILEGED
)での実行もサポートします。詳細については、エージェントの実行モードに関するドキュメントを参照してください。
重要
非rootユーザー( PRIVILEGED
またはUNPRIVILEGED
)としてエージェントを実行するには、tarballで提供されるフォルダーとファイルへの読み取り/書き込みアクセスを許可してください。
ランニングモードを変更するには
サービススクリプトを編集します。
エージェントを
PRIVILEGED
として実行している場合は、次の2つのLinux機能を追加する必要があります。libcap
ライブラリがホストにインストールされていることを確認してください。 (それに付属するsetcap
およびgetcap
コマンドが必要です。)tarballの中身を取り出し、root権限で以下のコマンドを実行する。
bash$setcap CAP_SYS_PTRACE,CAP_DAC_READ_SEARCH=+ep ./newrelic-infra/usr/bin/newrelic-infraランモードは、現在のユーザーとそれに割り当てられたカーネル能力に基づいて選択されます。
プラグインディレクトリの設定
インフラストラクチャエージェントを使用すると、Kubernetes、AWS、MySQL、Redis、Kafkaなどの一般的なサービスからのデータを監視およびレポートする統合をインストールできます。各統合には、デフォルトでintegration-name-config.yml
という名前の独自の構成ファイルが事前定義された場所に配置されます。 /etc/newrelic-infra/integrations.d/
。初期化時に、エージェントは設定ファイルをロードします。
統合設定ファイルの定義済みの場所を上書きするには、次のいずれかの方法を使用します。
NRIA_PLUGIN_DIR
環境変数に場所を設定します。plugin_dir
フィールドを使用してnewrelic-infra.yml
構成ファイルにカスタムパスを設定します。newrelic-infra
バイナリを実行するときに、-plugin_dir
を使用してコマンドライン引数として渡します。
エージェントディレクトリの設定
エージェントは、インストールされた統合、キャッシュデータ(インベントリ)などを実行するために、独自に定義されたディレクトリを必要とします。デフォルトの場所は/var/db/newrelic-infra/
です。
エージェントディレクトリは、以下のような構造と内容になっています。
LICENSE
:NewRelicインフラストラクチャエージェントライセンスを含むテキストファイル。custom-integrations
:インストールされたカスタム統合を格納するディレクトリ。newrelic-integrations
: NewRelicの公式統合を保存するディレクトリ。data
:エージェントがキャッシュデータを保存するディレクトリ(インベントリ)。
重要
エージェントを実行する ユーザーは、エージェント ディレクトリに対する読み取り/書き込み権限を持っている必要があります。
エージェントディレクトリの定義済みの場所を上書きするには、次のいずれかの方法を使用します。
NRIA_AGENT_DIR
環境変数に場所を設定します。agent_dir
フィールドを使用してnewrelic-infra.yml
構成ファイルにカスタムパスを設定します。newrelic-infra
バイナリを実行するときに、-agent_dir
を使用してコマンドライン引数として渡します。
ログファイルの設定
デフォルトでは、エージェントはログファイルを/var/db/newrelic-infra/newrelic-infra.log
に保存します。
重要
エージェントを実行する ユーザーは、ログ ファイルに対する書き込み権限を持っている必要があります。
ログファイルの定義済みの場所を上書きするには、次のいずれかの方法を使用します。
NRIA_LOG_FILE
環境変数に場所を設定します。log_file
フィールドを使用してnewrelic-infra.yml
構成ファイルにカスタムパスを設定します。newrelic-infra
バイナリを実行するときに、-log_file
を使用してコマンドライン引数として渡します。
エージェント・バイナリの位置の変更
実行ファイルの場所を変更するには、サービススクリプトを編集します。
次は何ですか?
次の設定も可能です。
- カスタムアトリビュートを追加して、Infrastructureデータに注釈を付けます。
- AWSアカウントを接続します(お使いのサーバーがAmazon EC2上で稼働している場合)。
- ログ転送を有効にします。
- Flex 実行可能ファイルを手動で追加して、 Flex 統合を有効にします。
- 他の インフラストラクチャの統合を追加 外部サービスからデータを収集します。
- 手動で 起動、停止、再起動、またはエージェントの状態を確認.