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

統合モニタリング・エージェントのインストール方法、新規インスタンス、既存のインスタンス、またはカスタム・イメージから作成されたインスタンス、および非Oracle Cloud Infrastructureインスタンスのいずれに対しても学習します。

サポートされているオペレーティング・システムを持つ新しいOracle Cloud Infrastructureインスタンスでは、作成時にエージェントを直接有効化できます。サポートされるオペレーティング・システムが含まれる新規および既存のインスタンスでは、カスタム・ログ・モニタリング・プラグインが有効で、すべてのプラグインが実行されている必要があります。詳細は、使用可能なプラグインを参照してください。

手動インストール

カスタム・ログ・モニタリング・プラグインがすでに有効になっている場合、インスタンスに自動的にパッチ適用され、エージェントがインストールされます。それ以外の場合、次の手動インストール手順を使用できます。

次のコマンドを実行して、各OSの最新のエージェント・ダウンロード・バージョンの詳細を取得します:

oci os object get --namespace axmjwnk4dzjv --bucket-name unified-monitoring-agent-config --name versionInfoV2.yml --file versionInfoV2.yml --profile <profile-name> --auth security_token

このコマンドは、次の内容でversionInfoV2.ymlファイルをダウンロードします。

versionInfoComposite:
  Oracle Linux Server:
    prefix: "unified-monitoring-agent-ol-"
    stableVersion: "0.1.25"
    postStableVersionComposite:
      default:
  CentOS Linux:
    prefix: "unified-monitoring-agent-cl-"
    stableVersion: "0.1.25"
    postStableVersionComposite:
      default:
  Ubuntu:
    prefix: "unified-monitoring-agent-ub-"
    stableVersion: "0.1.25"
    postStableVersionComposite:
      default:
  Windows:
    prefix: "unified-monitoring-agent-win-"
    stableVersion: "0.1.2"
    postStableVersionComposite:
      default:
  Debian GNU/Linux:
    prefix: "unified-monitoring-agent-deb-"
    stableVersion: "0.1.25"
    postStableVersionComposite:
      default:

versionInfoV2.ymlのstableVersionフィールドには、各OSに使用する最新バージョン番号が表示されます。適切なバージョン番号が見つかったら、LinuxかWindowsかに関係なく、次の設定ステップを実行します。

Linux:

インスタンスに接続します。
CLIでのトークンベースの認証の設定

次のコマンドを使用して、特定のOSバージョンの<bucket>、<name>および<file>を置き換えながら、Linux OSの非FIPSまたはFIPS対応エージェントをダウンロードします。

oci os object get --namespace axmjwnk4dzjv --bucket-name <bucket> --name <name> --file <file> --profile OC1 --auth security_token


OSバージョン	`<バケット>`	`<Name>`および`<File>`
非FIPSエージェント
Oracle Linux 7	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-7-<version>.rpm`
Oracle Linux 8	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-8-<version>.rpm`
CentOS 7	`unified-monitoring-agent-cl-bucket`	`unified-monitoring-agent-cl-7-<version>.rpm`
Ubuntu 16.04	`unified-monitoring-agent-ub-bucket`	`unified-monitoring-agent-ub-16-<version>.deb`
Ubuntu 18.04	`unified-monitoring-agent-ub-bucket`	`unified-monitoring-agent-ub-18-<version>.deb`
Ubuntu 20.04	`unified-monitoring-agent-ub-bucket`	`unified-monitoring-agent-ub-20-<version>.deb`
FIPS対応エージェント
Oracle Linux 7	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-7-fips-<version>.rpm`
Oracle Linux 8	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-8-fips-<version>.rpm`

ノート

FIPS対応エージェントを使用すると、パフォーマンスが影響を受けます。

次のコマンドを実行してRPMをインストールします:
```
yum install -y <rpm-name>
```
Ubuntuの場合:
```
apt install -y <deb-package-name>
```

Windows:

インスタンスに接続します。
CLIでのトークンベースの認証の設定

特定の Windows OSバージョンの <name>と <file>を置き換えながら、Windows Server 2012、2016、および2019のエージェントをダウンロードするには、次のコマンドを使用します。

oci os object get --namespace axmjwnk4dzjv --bucket-name unified-monitoring-agent-win-bucket --name <name> --file <file> --profile OC1 --auth security_token


OSバージョン	`<Name>`および`<File>`
Windows 2012	`unified-monitoring-agent-win-2012-<version>.msi`
Windows 2016	`unified-monitoring-agent-win-2016-<version>.msi`
Windowsの場合	`unified-monitoring-agent-win-2019-<version>.msi`

昇格されたコマンド・プロンプト(管理者として)を開き、MSIコマンドを実行します。インストールの完了には最大で5分かかります:
```
C:\path\to\file\<unified monitoring agent msi>
```
前述のコマンドのより高度なバージョンでは、MSIインストールの問題をデバッグします。
```
msiexec /i "C:\path\to\file\<unified monitoring agent msi>" /l*v "C:\unified-monitoring-agent_msi.log"
```

カスタム・イメージおよび非Oracle Cloud Infrastructureインスタンスから作成されたインスタンス

Manual Installationの同じ手順に従って、エージェントをインストールします。
実行中のインスタンスのユーザーAPIキーを構成します。ユーザーAPIキーを生成するには、API署名キーの生成方法で説明されている手順に従います。
- (Linux)".oci"ディレクトリとその内容を/etc/unified-monitoring-agent以下に配置します。
- (Windows)Windowsの場合、ステップが異なるため、適切なステップに従ってください。".oci"フォルダとその内容をディレクトリC:\oracle_unified_agent内に作成します。
Oracle Cloud Infrastructure CLI構成ファイルでのプロファイルの作成で説明されている手順に従って、次のステップの変更を含む構成ファイルを作成します。
Oracle Cloud Infrastructure CLI構成ファイルでのプロファイルの作成のステップに従った後、必ずこのセクションのプロファイル(<profile-name>)に"UNIFIED_MONITORING_AGENT"という名前を付けます。
次に、サービスでの認証に使用する統合モニタリング・エージェントの構成例を示します:
```
[UNIFIED_MONITORING_AGENT]
user=ocid1.user.region..aaa...
fingerprint=<cert fingerprint>
key_file=/path/to/ocifolder/.oci/private.pem
tenancy=ocid1.tenancy.region..aaa...
region=<instances region>
pass_phrase="pashphrase1234"
```

Oracle Cloud Infrastructureドキュメント

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

手動インストール

カスタム・イメージおよび非Oracle Cloud Infrastructureインスタンスから作成されたインスタンス