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

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

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

手動インストール

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

次のコマンドを実行して、各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.37"
    postStableVersionComposite:
      default:
  CentOS Linux:
    prefix: "unified-monitoring-agent-cl-"
    stableVersion: "0.1.37"
    postStableVersionComposite:
      default:
  Ubuntu:
    prefix: "unified-monitoring-agent-ub-"
    stableVersion: "0.1.37"
    postStableVersionComposite:
      default:
  Windows:
    prefix: "unified-monitoring-agent-win-"
    stableVersion: "0.1.37"
    postStableVersionComposite:
      default:
  Debian GNU/Linux:
    prefix: "unified-monitoring-agent-deb-"
    stableVersion: "0.1.37"
    postStableVersionComposite:
      default:

versionInfoV2.ymlのstableVersionフィールドには、OSごとに使用する最新バージョン番号が表示されます。

ノート

Red Hat Linuxパッケージの場合は、Oracle Linux Serverセクションを使用してバージョン番号を指定します。

適切なバージョン番号が見つかったら、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エージェント: x86
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`
Oracle Linux 9	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-9-<version>.rpm`
CentOS 7	`unified-monitoring-agent-cl-bucket`	`unified-monitoring-agent-cl-7-<version>.rpm`
Red Hat Enterprise Linux 8	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-8-<version>.rpm`
Red Hat Enterprise Linux 9	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-9-<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`
Ubuntu 22.04	`unified-monitoring-agent-ub-bucket`	`unified-monitoring-agent-ub-22-<version>.deb`
非FIPSエージェント: ARM
Oracle Linux 7	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-7-<version>.aarch64.rpm`
Oracle Linux 8	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-8-<version>.aarch64.rpm`
Oracle Linux 9	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-9-<version>.aarch64.rpm`
Red Hat Enterprise Linux 8	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-8-<version>.aarch64.rpm`
Red Hat Enterprise Linux 9	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-9-<version>.aarch64.rpm`
FIPS対応エージェント: x86
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`
Red Hat Enterprise Linux 8	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-8-fips-<version>.rpm`
FIPS対応エージェント: ARM
Oracle Linux 7	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-7-fips-<version>.aarch64.rpm`
Oracle Linux 8	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-8-fips-<version>.aarch64.rpm`
Red Hat Enterprise Linux 8	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-8-fips-<version>.aarch64.rpm`

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

Windows:

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

次のコマンドを使用して、Windows Server 2012、2016、2019および2022の非FIPSまたはFIPS対応エージェントをダウンロードし、特定のWindows OSバージョンの<name>および<file>を置換します。

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>`
非FIPSエージェント
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`
Windows 2022	`unified-monitoring-agent-win-2022-<version>.msi`
FIPS対応エージェント
Windows 2012	`unified-monitoring-agent-win-2012-fips-<version>.msi`
Windows 2016	`unified-monitoring-agent-win-2016-fips-<version>.msi`
Windows 2019	`unified-monitoring-agent-win-2019-fips-<version>.msi`
Windows 2022	`unified-monitoring-agent-win-2022-fips-<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インスタンスから作成されたインスタンス