Oracle Cloud Infrastructureドキュメント

カスタム・メトリックの公開

ここでは、独自のカスタム・メトリックをモニタリング・サービスに公開する方法について説明します。

APIを使用して、独自のメトリックをモニタリングに公開できます。 コンソールを使用して発行済メトリックのチャートを表示し、APIを使用してメトリックを問い合せ、コンソールまたはAPIを使用してアラームを設定できます。

警告

Oracle Cloud Infrastructureコンソール、APIまたはCLIを使用してクラウド・リソースに説明、タグまたはわかりやすい名前を割り当てるときは、機密情報を入力しないでください。

前提条件

IAMポリシー: カスタム・メトリックを公開するには、管理者によって作成されたポリシーに必要なタイプのアクセス権が付与されている必要があります。 この要件は、コンソールを使用しているか、SDK、CLIまたはその他のツールでREST APIを使用しているかにかかわらず適用されます。 権限のないメッセージまたは権限のないメッセージが表示された場合は、管理者に問い合せてください。 現在のコンパートメントに必要なアクセス権タイプを設定できません。 管理者: 関連する共通ポリシーについては、「カスタム・メトリックの公開をユーザーに許可」を参照してください。

APIの使用

APIおよび署名リクエストの使用については、REST APIおよび「セキュリティ資格証明」を参照してください。 SDKの詳細は、「ソフトウェア開発キットとコマンドライン・インタフェース」を参照してください。

ノート

カスタム・メトリックを定義するときは、次の点に注意してください:

  • カスタム・メトリックが制限を超えないようにしてください。 たとえば、カスタム・メトリックに対して有効なディメンションの範囲と最大ストリーム数を書き留めます。 PostMetricDataを参照してください。
  • 集計を考慮してメトリックを定義します。 カスタム・メトリックは秒ごと(1秒の最小頻度)として頻繁に送信できますが、最小集計間隔は1分です。
  • 戻り制限を考慮してメトリックを定義してください。 戻されたデータの情報を制限するために、最大値と「時間範囲の最大値(間隔に関連する解像度で決定)」の100,000のデータ・ポイントがあります。 『MetricDataリファレンス』を参照してください。

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

PostMetricData

ノート

次が推奨されます。 

  • リクエストごとにメトリック・ストリームを最大化するために、バッチ処理リクエストを送信します。 バッチ処理されたリクエストには、複数のメトリックまたはメトリック・ネームスペースが含まれています。 ノート制限。 PostMetricDataを参照してください。
  • 関連するコンテキストでモニターが必要な場合、つまりデータ・ポイントを収集する必要がある場合にのみメトリックを公開します。 監視が存在しない場合、非アクティブ期間中にメトリックを公開する必要がある場合、発行用に"0"値を手動で作成できます。
バッチ処理したリクエストの例

公開したカスタム・メトリックには、モニター・サービスに格納されているその他のメトリックにアクセスする場合と同じ方法でアクセスできます。 「問合せからチャートを表示」では、コンソール、「問合せメトリック」(CLIまたはAPIを使用)および「アラームの設定」 (コンソール、CLI、またはAPIを使用)を使用します。