Linux用インフラストラクチャ・エージェントのtarballによる手動インストール

インフラストラクチャ・モニタリングのためのカスタムLinuxインストール・プロセスでは、インストール・プロセスのすべての側面をカスタマイズし、ファイルシステム上にファイルやフォルダを配置することができます。インストールを完全にコントロールすることができます。

注意

手動インストールのプロセスは監視されていません。手動インストールを選択した場合、異なるファイルを正しいフォルダに配置し、パラメータ化された正しい設定値を提供し、エージェントが実行するためのすべての権限を持っていることを確認する責任があります。

エージェントのインストール

インストールする前に、互換性と要件を確認してください。

エージェントパッケージの追加オプション	コメントコメント
トラブルシューティング	インフラストラクチャエージェントパッケージには、実行中のエージェントのトラブルシューティングに役立つ追加の`newrelic-infra-ctl`バイナリが含まれています。このバイナリはエージェントの実行に必須ではありませんが、パスに追加することをお勧めします。
デーモン・プロセス	バージョン1.5.59以降、インフラストラクチャエージェントパッケージには、通常のエージェントデーモンプロセス`newrelic-infra`を安全に管理するために使用される追加の`newrelic-infra-service`バイナリが含まれています。

エージェントをインストールするには

パッケージ化されたエージェントファイルをダウンロードするか、次のコマンドを使用して、エージェントの特定のバージョンとそのチェックサムを自動的にフェッチし、ダウンロード後に検証します。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ディストリビューションの公式ドキュメントをご確認ください。

ホストで使用されているサービスマネージャーをプログラムで知る良い方法はありませんが、いくつかのヒューリスティックな方法をご紹介します。

サービスマネージャーを決定するには、以下のコマンドを使用します。

command -v systemctl （Systemdで使用）
command -v update-rc.d （SysVで使用）
command -v initctl （Upstartで使用）
出力される最初のコマンドは、システムがどのサービスマネージャーを使用しているかを示しています。
ヒント
例えば、次のようなシーケンスを実行します。
bash
```
$command -v systemctl
$command -v initctl
/sbin/initctl
```
この出力に基づけば、「アップスタート」はリターンを得たコマンドであるため、サービスマネージャーとなります。

重要

サービスマネージャースクリプトをコピーする前に、ユーザ、エージェントのバイナリのパス、またはpidファイルの場所を変更する必要があるかどうかを確認します。これらの変更はすべてサービス・スクリプトに反映させる必要があります。

サポートされているサービスマネージャーのいずれかを使用している場合は、ホスト用のサービススクリプトをインストールします。

サービスファイル./newrelic-infra/etc/init_scripts/systemd/newrelic-infra.serviceをにコピーします /etc/systemd/system/newrelic-infra.service
サービススクリプトを有効にします。
bash
```
$systemctl enable newrelic-infra.service
```

サービスファイル./newrelic-infra/etc/init_scripts/sysv/newrelic-infraをにコピーします /etc/init.d/system/newrelic-infra

以下のコマンドを実行してください。

bash

$update-rc.d newrelic-infra defaults
$update-rc.d newrelic-infra enable

サービスファイル./newrelic-infra/etc/init_scripts/upstart/newrelic-infraをにコピーします /etc/init/newrelic-infra.conf
次のコマンドを実行してください。
bash
```
$initctl reload-configuration
```

サービススクリプトの設定が完了しました。残りのオプションを設定し、手動でサービスを開始します。

設定ファイルの保存場所の変更

インフラストラクチャエージェントには、エージェントの動作を微調整するために、通常はnewrelic-infra.ymlという名前の構成ファイルが含まれています。詳細については、構成ファイルテンプレートおよびエージェントの構成方法を参照してください。

デフォルトでは、エージェントはこれらの場所のいずれかで設定ファイルを検索します。

newrelic-infra.yml （作業ディレクトリのルートフォルダ）
/etc/newrelic-infra.yml
/etc/newrelic-infra/newrelic-infra.yml

別の場所を指定するには、 -configフラグコマンドラインを使用します。例えば：

bash

$usr/bin/newrelic-infra -config /whatever/path/custom_config_name.yml

この変更を恒久的なものにするには、サービススクリプトを編集します。

サービススクリプト./newrelic-infra/etc/init_scripts/systemd/newrelic-infra.serviceを開きます。
行ExecStart=/usr/bin/newrelic-infraを検索します。
構成フラグと構成ファイルのパスを追加します。この例では、構成ファイルは/optディレクトリExecStart=/usr/bin/newrelic-infra -config /opt/config.yamlにあります。
ファイルを保存します。

pidファイルの保存場所の変更

インフラストラクチャエージェントは、 pid-fileを使用して、エージェントの実行中のインスタンスを識別するために使用されるプロセス識別番号（pid）を保持します。 pid-fileの場所を変更する方法は、エージェントの構成方法によって異なります。

重要

デフォルトでは、エージェントがpid-fileを作成することをお勧めします。必要に応じて場所を編集できます。

pid-fileの場所を変更するには：

起動時に、エージェントはプロセスpidをpid-fileに書き込みます。ファイルが存在しない場合は、ファイルが作成されます。

デフォルトでは、エージェントはパス/var/run/newrelic-infra/newrelic-infra.pidを使用してpid-fileを作成します。変更するには、次のいずれかのオプションを使用します。

構成ファイルnewrelic-infra.ymlにpid_file構成オプションを追加します。
newrelic-infraバイナリを実行するときに、コマンドラインを使用してpid_fileを指定します。
NRIA_PID_FILE環境変数を設定します。
重要
エージェントは、初期化されるたびにpid-fileを作成または更新するため、エージェントを実行するユーザーは、 pid-fileの場所に対する読み取り/書き込み権限を持っている必要があります。
chownコマンドを使用して、ユーザーに所有者権限を付与します。たとえば、ユーザーnri-agentがエージェントを実行していて、 pid-fileの場所が/var/run/newrelic-infra-custom/nr.pidに設定されている場合、次のコマンドでユーザー権限を付与できます。
bash
```
$chown nri-agent:nri-agent /var/run/newrelic-infra-custom/
```

注意

pid-fileを管理するためにPIDFILE環境変数を使用することはお勧めしません。

環境変数PIDFILEが設定されている場合、エージェントはpid-fileの作成を試みません。選択した場所にpid-fileを作成します。

ヒント

他の誰かがpid-fileのライフサイクルを管理している場合は、このアプローチを使用してください。たとえば、 initスクリプトは、 pid-fileの作成とコンテンツを処理するため、SysVなどの一部のサービスマネージャーのPIDFILE変数を設定します。

ユーザーおよびランタイムモードの変更

Linuxエージェントはデフォルトでrootとして実行されますが、特権が少ないユーザー（ PRIVILEGEDおよびUNPRIVILEGED ）での実行もサポートします。詳細については、エージェントの実行モードに関するドキュメントを参照してください。

重要

非rootユーザー（ PRIVILEGEDまたはUNPRIVILEGED ）としてエージェントを実行するには、tarballで提供されるフォルダーとファイルへの読み取り/書き込みアクセスを許可してください。

ランニングモードを変更するには

サービススクリプトを編集します。
サービススクリプト./newrelic-infra/etc/init_scripts/systemd/newrelic-infra.serviceを開きます。
行[Service]を検索します。
行User=user_nameを追加し、 user_nameをエージェントを実行するユーザー（ PRIVILEGEDまたはUNPRIVILEGED ）に置き換えます。
ファイルを保存します。
サービススクリプト./newrelic-infra/etc/init_scripts/sysv/newrelic-infraを開きます。
行USER=rootを検索します。
rootを、エージェントを実行するユーザー（ PRIVILEGEDまたはUNPRIVILEGED ）に置き換えます。
ファイルを保存します。
サービススクリプト./newrelic-infra/etc/init_scripts/upstart/newrelic-infraを開きます。
行exec /usr/bin/newrelic-infraを検索します。
exec su -s /bin/sh -c ‘exec “$0” “$@“’ user_name-- /usr/bin/newrelic-infraに置き換えます。
user_nameを、エージェントを実行するユーザー（ PRIVILEGEDまたはUNPRIVILEGED ）に置き換えます。
ファイルを保存します。
エージェントをPRIVILEGEDとして実行している場合は、次の2つのLinux機能を追加する必要があります。
1. libcapライブラリがホストにインストールされていることを確認してください。（それに付属するsetcapおよびgetcapコマンドが必要です。）
2. tarballの中身を取り出し、root権限で以下のコマンドを実行する。
  bash
```
$setcap CAP_SYS_PTRACE,CAP_DAC_READ_SEARCH=+ep ./newrelic-infra/usr/bin/newrelic-infra
```
3. ランモードは、現在のユーザーとそれに割り当てられたカーネル能力に基づいて選択されます。

プラグインディレクトリの設定

インフラストラクチャエージェントを使用すると、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 統合を有効にします。
他のインフラストラクチャの統合を追加外部サービスからデータを収集します。
手動で起動、停止、再起動、またはエージェントの状態を確認.

この機械翻訳は、参考として提供されています。

Linux用インフラストラクチャ・エージェントのtarballによる手動インストール

注意

エージェントのインストール

インストールします。オプションの手順

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

サービススクリプトのインストール

重要

サービス担当者の決定

ヒント

重要

Systemd

SysV

Upstart

設定ファイルの保存場所の変更

Systemd

SysV

Upstart

pidファイルの保存場所の変更

重要

エージェントがpidファイルを作成すると

重要

エージェントがPIDFILE環境変数を使用する場合

注意

ヒント

ユーザーおよびランタイムモードの変更

重要

Systemd

SysV

Upstart

プラグインディレクトリの設定

エージェントディレクトリの設定

重要

ログファイルの設定

重要

エージェント・バイナリの位置の変更

Systemd

SysV

Upstart

次は何ですか？

この機械翻訳は、参考として提供されています。

Linux用インフラストラクチャ・エージェントのtarballによる手動インストール

注意

エージェントのインストール .css-21sua1{background:none;border:none;width:0;padding:0;}

インストールします。オプションの手順

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

サービススクリプトのインストール

重要

重要

Systemd

SysV

Upstart

設定ファイルの保存場所の変更

Systemd

SysV

Upstart

pidファイルの保存場所の変更

重要

エージェントがpidファイルを作成すると

エージェントがPIDFILE環境変数を使用する場合

ユーザーおよびランタイムモードの変更

重要

Systemd

SysV

Upstart

プラグインディレクトリの設定

エージェントディレクトリの設定

重要

ログファイルの設定

重要

エージェント・バイナリの位置の変更

Systemd

SysV

Upstart

次は何ですか？

エージェントのインストール