概要

Oracle Cloud Infrastructure（OCI）上に作成したVM(Windows)のディスク使用率をカスタムメトリックを使って監視します

Pythonを使った例は以下に記載しております

今回は以下の前提で作成しています

WindowsサーバーのCドライブを監視
.NETを使用
資格情報はインスタンスプリンシパルを使用

準備

OCI

インスタンスで認証するためのインスタンスプリンシパルを設定します

動的グループ作成
OCIコンソールのナビゲーションメニューからアイデンティティとセキュリティ>>ドメイン(Default)>>動的グループを選択して「動的グループの作成」を押下
- 名前：任意の名前を設定
- 一致ルール：
- コンパートメント配下インスタンスを動的グループとして指定
- "下で定義したいずれかのルールに一致"を選択してルールを記述

instance.compartment.id = '【コンパートメントOCID ocid1.compartment.oc1..】resource.compartment.id = '【コンパートメントOCID ocid1.compartment.oc1..】

参考
動的グループを定義するための一致ルールの記述

ポリシー作成
OCIコンソールのナビゲーションメニューからアイデンティティとセキュリティ>>ポリシーを選択して「ポリシーの作成」を押下
- ルールを記述

Allow dynamic-group 【動的グループ】 to use metrics in compartment 【コンパートメント】

参考
ポリシーリファレンスモニタリングの詳細

Windows

Disk使用率を定期的にカスタムメトリックにPostする仕組みを作成します

Windows Serverに.NET SDKをインストール
.NET のダウンロード
バージョン確認

C:\path\to> dotnet --version
9.0.300

フォルダ作成
diskcheck_dotnet_cを作成しました
C# .NETコンソール・アプリケーションを作成します

C:\path\to> cd diskcheck_dotnet_c
C:\path\to\diskcheck_dotnet_c> dotnet new console
テンプレート "コンソール アプリ" が正常に作成されました。

作成後の操作を処理しています...
C:\path\to\diskcheck_dotnet_c\diskcheck_dotnet_c.csproj を復元しています:
正常に復元されました。

OCI SDKパッケージを追加します

C:\path\to\diskcheck_dotnet_c> dotnet add package OCI.DotNetSDK.Common
C:\path\to\diskcheck_dotnet_c> dotnet add package OCI.DotNetSDK.Monitoring

Program.csのコードを置き換え作成
以下は環境に合わせてください
- DriveInfo("C"): Dドライブを監視する場合はDに変更
- .[CompartmentOCID]:コンパートメントOCID
- .[ServerID]:Serverの名前
- https ://telemetry-ingestion.ap-tokyo-1.oraclecloud.com :osakaはap-osaka-1

using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Oci.MonitoringService;
using Oci.Common;
using Oci.Common.Auth;

namespace Oci.Sdk.DotNet.Example.Monitoring
{
    public class PostMetricDataExample
    {
        public static async Task Main()
        {
            // Get drive usage
            DriveInfo drive = new DriveInfo("C");
            double usedPercentage = Math.Round(((double)(drive.TotalSize - drive.AvailableFreeSpace) / drive.TotalSize) * 100);
            // Create a request and dependent object(s).
            var postMetricDataDetails = new Oci.MonitoringService.Models.PostMetricDataDetails
            {
                MetricData = new List<Oci.MonitoringService.Models.MetricDataDetails>
                {
                    new Oci.MonitoringService.Models.MetricDataDetails
                    {
                        Namespace = "custom_metrics",
                        CompartmentId = "[CompartmentOCID]",
                        Name = "disk_usage",
                        Dimensions = new Dictionary<string, string>()
                        {
                            {
                                "server_id", 
                                "[ServerID]"
                            }
                        },
                        Datapoints = new List<Oci.MonitoringService.Models.Datapoint>
                        {
                            new Oci.MonitoringService.Models.Datapoint
                            {
                                Timestamp = DateTime.UtcNow,
                                Value = usedPercentage,
                            }
                        }
                    }
                },
                BatchAtomicity = Oci.MonitoringService.Models.PostMetricDataDetails.BatchAtomicityEnum.Atomic
            };
            var postMetricDataRequest = new Oci.MonitoringService.Requests.PostMetricDataRequest
            {
                PostMetricDataDetails = postMetricDataDetails
            };
            // Create a Instance Principals Authentication
            var provider = new InstancePrincipalsAuthenticationDetailsProvider();
            var client = new MonitoringClient(provider, new ClientConfiguration());
            string serviceEndpoint = "https://telemetry-ingestion.ap-tokyo-1.oraclecloud.com";
            client.SetEndpoint(serviceEndpoint);
            try
            {
                // Create a service client and send the request.
                var response = await client.PostMetricData(postMetricDataRequest);
                // Retrieve value from the response.
                var failedMetricsCountValue = response.PostMetricDataResponseDetails.FailedMetricsCount;
            }
            catch
            {
                throw;
            }
        }

    }
}

コマンドを実行してエラーがないことを確認します

C:\path\to\diskcheck_dotnet_c> dotnet run

バッチ作成してタスクスケジューラで実行可能にします

diskcheck_dotnet_c.bat

@echo off
cd /d C:\path\to\diskcheck_dotnet_c
dotnet run

タスクスケジューラ作成
1時間ごとに実行するよう定期実行を設定します

タスクスケジューラ

全般

トリガー

トリガー詳細

操作

操作詳細

アラーム定義作成

アラーム定義
- OCIコンソールメニューから監視および管理>>モニタリング>>アラーム定義を選択
- 「アラームの作成」ボタンを押下
- アラーム名、重大度選択およびアラーム本体を設定
- メトリック・ネームスペースはcustom_metricsを指定
- メトリック名にdisk_usageを指定
- 間隔時間を指定
- 統計にMeanを指定
- メトリック・ディメンション名はserver_id、ディメンション値で対象hostを指定します
- トリガー・ルールでアラーム起動条件を指定。例えばディスク使用率90%超が2時間連続して発生を条件とする場合は、演算子：次より大きい、値：90、トリガー遅延分数：60を指定
- 宛先に作成済の通知設定を選択
- 「アラームの保存」ボタンを押下

参考

APIを使用したカスタム・メトリックの公開

API Reference and Endpoints PostMetricData

SDK for .NETストリーミング・クイックスタート