エージェントのインストール
統合モニタリング・エージェントをインストールする方法について学習します。これは、新しいインスタンス、既存のインスタンス、またはカスタム・イメージから作成されたインスタンス、およびOracle Cloud Infrastructure以外のインスタンスに対するものです。
エージェント(統合モニタリング・エージェント)は、「カスタム・ログ・モニタリング」と呼ばれるOracle Cloud Agentプラグインとも呼ばれます。
サポートされているオペレーティング・システムを持つ新しい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.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 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 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 Server 2012、2016および2019のエージェントをダウンロードし、特定の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> Windows 2012 unified-monitoring-agent-win-2012-<version>.msi
Windows 2016 unified-monitoring-agent-win-2016-<version>.msi
Windows 2019 unified-monitoring-agent-win-2019-<version>.msi
Windows 2022 unified-monitoring-agent-win-2022-<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インスタンスから作成されたインスタンス
- 手動インストールの同じステップに従ってエージェントをインストールします。
- 実行中のインスタンスのユーザーAPIキーを構成します。ユーザーAPIキーを生成するには、API署名キーの生成方法で説明されている手順に従います。
- (Linux)".oci"ディレクトリとその内容を
/etc/unified-monitoring-agent
以下に配置します。 - (Windows)Windowsの場合、ステップが異なるため、適切なステップに従ってください。".oci"フォルダとその内容をディレクトリ
C:\oracle_unified_agent
内に作成します。
- (Linux)".oci"ディレクトリとその内容を
- 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"