• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

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

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

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

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

注意

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

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

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

エージェントパッケージの追加オプション

コメントコメント

トラブルシューティング

インフラストラクチャ エージェント パッケージには、実行中のエージェントのトラブルシューティングに役立つ追加のnewrelic-infra-ctlバイナリが含まれています。このバイナリはエージェントの実行に必須ではありませんが、パスに追加することをお勧めします。

デーモン・プロセス

バージョン1.5.59以降、インフラストラクチャエージェントパッケージには、通常のエージェントデーモンプロセスnewrelic-infraを安全に管理するために使用される追加のnewrelic-infra-serviceバイナリが含まれています。

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

  1. パッケージ化されたエージェントファイルをダウンロードするか、次のコマンドを使用して、エージェントの特定のバージョンとそのチェックサムを自動的にフェッチし、ダウンロード後に検証します。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のインフラエージェントリポジトリで、署名手順と検証手順を確認できます。

  2. ファイルを解凍します。

  3. ファイルが以下のような構造で解凍されることを確認してください。

    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
  4. サービススクリプトのインストール.

  5. オプション: 追加のインストール手順.

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

また、これらの追加手順を実行することもできます。

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

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

サービススクリプトをインストールする前に、システムで使用しているサービスマネージャーを確認する必要があります。

  • サポートされているサービスマネージャー(SystemD、SysV、Upstart)のいずれかを使用している場合は、tarballに含まれるサービススクリプトを使用します。
  • 当社がサポートしていないサービスマネージャーをご利用の場合は、お客様ご自身でサービススクリプトを作成していただく必要があります。

重要

疑問がある場合は、お使いのLinuxディストリビューションの公式ドキュメントをご確認ください。

重要

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

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

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

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

インフラストラクチャエージェントには、エージェントの動作を微調整するために、通常は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

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

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

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

重要

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

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

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

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

重要

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

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

  1. サービススクリプトを編集します。

  2. エージェントを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-integrationsNewRelicの公式統合を保存するディレクトリ。
  • 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を使用してコマンドライン引数として渡します。

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

実行ファイルの場所を変更するには、サービススクリプトを編集します。

次は何ですか?

次の設定も可能です。

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.