LoginSignup
1
0
@watarun97

OCI StackMonitoringでメトリック拡張を設定する

Last updated at Posted at 2024-05-16

概要

Stack Monitoringでは任意のリソースに対してOSコマンドやSQLを利用してユーザー独自のメトリックを作成することができるメトリック拡張が利用できます。
本記事ではその手順を解説します。

前提条件

ポリシーの設定

管理エージェントがOCIモニタリングにメトリックをアップロードできるポリシー

ALLOW DYNAMIC-GROUP StackMonitoringManagementAgentsEasyOnboarding TO USE METRICS IN COMPARTMENT <compartment_name> where any {target.metrics.namespace='oracle_metric_extensions_appmgmt', target.metrics.namespace='oracle_metric_extensions_appmgmt_test'}

メトリック拡張を有効または無効にできるポリシー

ALLOW GROUP MeOperatorGroup TO USE stack-monitoring-metric-extension IN COMPARTMENT <compartment_name>

監視対象のメトリック拡張を有効または無効にできるポリシー

ALLOW GROUP MeOperatorGroup TO {STACK_MONITORING_RESOURCE_UPDATE, DBMGMT_MANAGED_DB_UPDATE, DBMGMT_MANAGED_DB_CONTENT_WRITE, DBMGMT_EXTERNAL_DBSYSTEM_UPDATE, DBMGMT_EXTERNAL_DBSYSTEM_CONTENT_WRITE}N COMPARTMENT <compartment_name>

メトリック拡張の設定

OSコマンドによるメトリック拡張

Oracle DatabaseのLisnerステータスを監視するメトリックをOSコマンドを追加します。
＊StackMonitoringがDatabaseのホストに設定済みとします。
リソース→メトリック拡張→「メトリック拡張の作成」をクリックします。
image.png

以下の項目を設定します。
＊必須項目は赤字
メトリック拡張のプロパティ

  • 名前：ME_ListnerStatus（任意）
  • 表示名：ListnerStatus（任意）

image.png

収集方法のプロパティ

  • リソース・タイプ：ホスト - Linux
  • 収集方法：OSコマンド
  • 収集頻度：5〜
  • コマンド：/bin/bash/　
  • 出力のデリミタ(オプション)
  • 引数(オプション)
  • 出力の接頭辞(オプション)
    • コマンド出力が sm_result= 3454 | abc | defの場合、Prefix for output = sm_resultは、sm_resultで始まる行のみがメトリックの収集に使用
  • スクリプトファイル(オプション)： LisnerStatus.sh
    • コマンドに直接記述も可能
LisnerStatus.sh
ps -ef | grep LISTENER | grep -v grep | wc -l

image.png

メトリック/ディメンション

  • 名前：LisnerStatus（任意）
  • 表示名(オプション)
  • ディメンションですか。：
    • ディメンションを指定する際は指定
      例: oci_computeagentメトリックの定義で指定されるリソース識別子(resourceId)
    • メトリックが、計算式を使用する他のメトリックの値の計算にのみ使用される場合、「はい」を選択します。
  • 単位：
  • カテゴリ：
    • 可用性、容量、ロード、使用率を指定
  • 計算式：
    • 他メトリックに対する演算に基づいて、メトリックの値を計算します。

image.png

上記の項目を設定したら、作成とテストをクリックします。
image.png

作成したメトリックをテストするために、メトリック拡張を適用する「テスト」をクリックします。
image.png

テストが成功したら公開をクリックします。
メトリックは一度公開すると、編集ができないのでご注意ください。
image.png

公開が完了したら、「有効化」をクリックします。
image.png

「リソースの選択」をクリックします。
image.png
該当のリソースを選択し、「選択したリソースで有効化」をクリックします。
image.png

公開が終わると該当リソースのチャート欄に作成したメトリックが追加されます。
image.png

SQLによるメトリック拡張

SQLによるメトリック拡張は非コンテナDB、CDB、PDBで利用可能です。
例としてDatabaseに登録されているユーザー数を取得するメトリックを追加します。

リソース→メトリック拡張→「メトリック拡張の作成」をクリックします。
image.png

メトリック拡張のプロパティ、収集方法のプロパティ、メトリック/ディメンションの項目を以下のように設定します。
＊必須項目は赤字

  • 名前：ME_AllUsers（任意の名前）
  • 表示名：AllUsers（任意の表示名）

メトリック拡張のプロパティ
image.png

収集方法のプロパティ
image.png

  • リソース・タイプ：非コンテナDB or コンテナDB or PDB
  • 収集方法：SQL
  • 収集頻度：5〜（任意）
  • SQL問合せ：SELECT COUNT(*) from ALL_USERS;
  • IN パラメータ(オプション)
  • OUT パラメータ(オプション)
  • OUT パラメータ・タイプ(オプション)

メトリック/ディメンション

  • 名前：AllUsers（任意の名前）
  • 表示名(オプション)
  • ディメンションですか。：なし
  • 単位(オプション)
  • カテゴリ(オプション)

image.png
上記の項目を設定したら、作成とテストをクリックします。
image.png
リソースの選択に適当なデータベースを選択して「テスト」をクリックします。
image.png

テストが成功したら公開をクリックします。
メトリックは一度公開すると、編集ができないのでご注意ください。
image.png

公開が完了したら、「有効化」をクリックします。
image.png

「リソースの選択」をクリックします。
image.png

該当のリソースを選択し、「選択したリソースで有効化」をクリックします。
image.png

公開が終わると該当リソースのチャート欄に作成したメトリックが追加されます。
image.png

有効化が完了するとと該当リソースのチャート欄に作成したメトリックが追加されます。
image.png

アラーム設定について

Stack Monitoringでは Monitoringを使用して、メトリックがしきい値を超えたときにアラームを生成できます。
メトリック拡張で追加したメトリックに対してアラームを定義する場合はoracle_metric_extentions_appmgmtを使用することでアラームを定義することができます。
image.png

ダッシュボードについて

メトリック拡張で追加したメトリックをダッシュボードに追加することが可能です。

image.png

スクリーンショット 2024-04-09 1.53.05.png

image.png

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
1
0