管理エージェントは、Oracle Cloud Infrastructureサービスが顧客のVMと安全に相互作用できるようにする一方向パイプを提供します。エージェントは、最も単純なネットワーク・トポロジで動作し、VM上での特別な構成は必要ありません。エージェントは、パフォーマンス・メトリックを収集して作業を実行するための拡張可能なモデルをOracle Cloud Infrastructureサービスに提供します。

管理エージェント・リソースのサービス・メトリックを使用すると、ユーザーはエージェントのリソース消費をCPU、メモリーおよびディスクでビジュアル化できます。

ディメンション

管理エージェントのメトリックには、次のディメンションが含まれます:

メトリック

管理エージェント・マーケットプレイス・アプリケーションのデフォルト・アラーム

アーキテクチャ

管理エージェントは他のOracle Cloud Infrastructureサービスと完全に統合されているため、リソース・マネージャおよびスタックを使用してログ・アナリティクスのメトリック・アラーム構成を簡単に自動化できます。アラームが定義されると、Monitoringサービスを使用して監視され、メトリックがNotificationsサービスを使用してアラーム指定のトリガーを満たしたときに通知されます。

前提条件

1. ユーザーには、管理エージェント、メトリックおよび通知トピックを管理するための権限またはポリシーが必要です。
2. ユーザーは管理グループの一部であるか、リソース・マネージャ・スタックを起動する権限を持っている必要があります。

   ユーザーが管理グループに含まれていない場合は、リソース・マネージャ・スタックを起動するために次の権限が必要です。

   # Policies required to manage stacks and jobs in OCI Resource Manager
   ALLOW GROUP <User-Group> TO MANAGE orm-stacks IN TENANCY
   ALLOW GROUP <User-Group> TO MANAGE orm-jobs IN TENANCY
    
   # Policies required to read and manage IAM resources
   ALLOW GROUP <User-Group> TO READ compartments IN TENANCY
   ALLOW GROUP <User-Group> TO READ tenancies IN TENANCY
   ALLOW GROUP <User-Group> TO MANAGE dynamic-groups IN TENANCY
   ALLOW GROUP <User-Group> TO MANAGE policies IN TENANCY
    
   # Policies required to manage Management Agents
   ALLOW GROUP <User-Group> TO MANAGE management-agents IN TENANCY
   ALLOW GROUP <User-Group> TO READ metrics IN TENANCY
    
   # Policies required to create and manage alarms and notification topics
   ALLOW GROUP <User-Group> TO MANAGE alarms IN TENANCY
   ALLOW GROUP <User-Group> TO USE ons-topics IN TENANCY

   ノート
   
   ポリシーを特定のコンパートメントに明示的に制限するには、TENANCYのかわりに<COMPARTMENT_NAME>を使用します。例:

   ALLOW GROUP <User-Group> TO MANAGE ALARMS IN COMPARTMENT <COMPARTMENT_NAME>.

   ユーザー・グループの作成および管理の詳細は、グループの管理を参照してください。

マーケットプレイス・アプリケーションを使用した管理エージェントのデフォルト・アラームのデプロイ

1. Oracle Cloudにサインインします。

2. ナビゲーション・メニューを開きます。「マーケットプレイス」で、「マーケットプレイス」をクリックしてすべてのアプリケーションを表示します。

3. 検索ボックスに移動し、管理エージェントを入力して、管理エージェントのデフォルト・アラーム・スタック・リストを選択します。

   リストの詳細が表示されます。

4. 「スタック・バージョン」および「コンパートメント」を選択します。

5. Oracle使用条件をレビューし、「確認して受諾しました」チェック・ボックスを選択します。

6. 「スタックの起動」をクリックします。

   「リソース・マネージャ」ページが表示され、「スタックの作成」プロセスが表示されます。

7. ステップ1の「スタック情報」で、スタック情報を確認します。

   • 「名前」で、自動移入された名前を確認してスタックを識別します。

   • 「説明」で、オプションでスタック・デプロイメントの説明を追加します。

   • 「コンパートメントに作成」で、ドロップダウン・リストからコンパートメントを選択します。

   • オプションで、ネームスペース・タグを指定してリソースを編成およびトラッキングします。

   • 次のステップを続行するには、「次」をクリックします。

8. ステップ2の「変数の構成」で、必要に応じてデフォルト設定を確認および更新します。

   • 「必要な構成」で、次を確認します:

     • 「管理エージェント・コンパートメント」で、管理エージェントがインストールされているコンパートメントを選択します。

       • ルート・コンパートメント/テナンシが選択されている場合は、「ネストされた管理エージェント・コンパートメントの有効化」チェック・ボックスが表示されます。サブコンパートメント内のエージェントをモニターしない場合は、このチェック・ボックスの選択を解除します。
       • サブスクリプションのない新しい通知宛先トピックを作成するには、「新規トピックの作成」チェック・ボックスを選択します。通知宛先トピックがすでに作成されている場合は、このチェック・ボックスの選択を解除します。
     • 「スタック識別子」に、作成するアラームおよび通知トピックを識別する一意の名前を入力します。
     • 「前提条件」で、必要なポリシーを確認して確認します。
   • 「管理エージェント・アラーム構成」で、デフォルトで作成される4つのアラーム定義を確認します。
     • アラームの設定を無効化または変更するには、「管理エージェント・アラームのカスタマイズ」を選択します。
       ノート
       
       アラームをモニターしない場合は(スタック作成から削除)、アラーム・チェック・ボックスの選択を解除します。
     • 管理エージェントの可用性を確認するアラームを設定するには、「可用性アラーム」を選択します。
     • 管理エージェントのCPUパーセンテージに対してアラームを設定するには、「CPUアラーム」を選択します。
     • 管理エージェントのディスク領域のアラームを設定するには、「ディスク・アラーム」を選択します。
     • 管理エージェントによって消費されるメモリー量をチェックするアラームを設定するには、「メモリー・アラーム」を選択します。
       ノート
       
       必要に応じて、アラームのアラーム間隔、しきい値および重大度を変更します。
   • 「ログ・アナリティクス・アラーム構成」で、デフォルトで作成される2つのアラーム定義を確認します。
     • アラームを設定するには、「ロギング分析メトリックの追加」を選択します。アラームが不要な場合は、このチェックボックスをオフにします。
     • 2つのアラームのいずれかの設定を削除または変更するには、「ロギング分析アラームのカスタマイズ」を選択します。
     • ログ収集アップロード・データ・サイズのアラームを設定するには、「ログ・アナリティクス・アップロード・データ・サイズ・アラーム」を選択します。
     • ログ収集のアップロードが失敗した場合にアラームを設定するには、「ログ・アナリティクス・アップロード失敗アラーム」を選択します。
9. ステップ3の「レビュー」で、すべての情報が正確で完全であることを確認します。

   • 「Run apply on the created stack?」で、「Run apply」チェック・ボックスの選択を解除します。

     これにより、このプロセスがスタックのみを作成するようになります。適用スタックは別のステップで実行されます。

10. 「作成」をクリックします。

    ページがスタックが作成されたことを示すまで待ってから、次のステップに進みます。

11. 「スタックの詳細」ページで、「プラン」をクリックしてプラン・ジョブを作成します。

    プラン・ジョブに一意の名前を指定し、「プラン」をクリックします。

12. 同じページの「ログ」セクションをレビューして、問題がないことを確認します。

13. ナビゲーション・メニューから「スタックの詳細」を選択します(「リソース・マネージャ」>「スタック」>「スタックの詳細」)。作成されたスタックで、「ジョブ情報」に移動し、「状態」にSucceededと表示されていることを確認します。

14. 「スタックの詳細」タブに移動し、「適用」をクリックします。

    • 適用ジョブを識別する一意の名前を指定します。

    • 「ジョブ・プランの解決の適用」を選択して、選択したものを自動的に承認します。

    • 「適用」をクリックして、適用ジョブを実行します。

      このプロセスによってアラーム定義が作成され、通知トピックにバインドされます。

      「ログ」セクションをレビューして、問題がないことを確認します。

    • 「ジョブ情報」タブで、「状態」にSucceededが表示されていることを確認します。

    • 「リソース」左メニューから、「出力」をクリックして実行出力情報を表示します。

Githubを使用した管理エージェントのデフォルト・アラームのデプロイ

Githubを使用して「管理エージェントのデフォルト・アラーム」スタックをデプロイすることもできます。

• https://github.com/oracle-quickstart/oci-observability-and-management/o11y-ingestion-monitoringにアクセスします。

• 「Oracle Cloudにデプロイ」をREADME.mdセクションからクリックします。

• Oracleの使用条件に同意し、「次」をクリックします。

• Resource Manegerを使用してスタックを適用します。

  「マーケットプレイス・アプリケーションを使用した管理エージェントのデフォルト・アラームのデプロイ」セクションに移動します。手順1から6をスキップし、手順7から始まる手順に従います。