問合せのディメンションの選択
モニタリングでメトリック・データを問い合せる際にディメンションを選択して、返されるメトリック・データを制限します。ディメンションはメトリック定義で指定される修飾子です。MQLでは、ディメンション選択コンポーネントは、中カッコで囲まれたディメンションの名前と値のペアを指定します。
問合せのトラブルシューティングについては、問合せのトラブルシューティングを参照してください。
考慮事項
テキストは、ディメンション名として受け入れられます。ディメンションが存在しない場合、データはフィルタ処理されません。
ディメンションが存在することを確認するには、メトリック名のディメンションをリストするか、サポートされているサービスを参照してください
- 例1: フォルト・ドメイン
-
CpuUtilization[1m]{faultDomain = "FAULT-DOMAIN-1"}.mean() - 例2: コンパートメント
-
IopsRead[1m]{compartmentId="ocid1.compartment.oc1.phx..exampleuniqueID"}.grouping().max() - 例3: シェイプ(グループ化あり)
-
CpuUtilization[1m]{shape="VM.Standard.E4.Flex"}.groupBy(availabilityDomain,poolId).mean() - 例4: 複数のディメンションの名前と値のペア: フォルト・ドメイン、名前およびシェイプ
-
CpuUtilization [1m]{faultDomain = "FAULT-DOMAIN-1", resourceDisplayName = "test", shape = "myshape"}.mean() - 例5: ディメンションの複数の値: フォルト・ドメイン1または2
-
CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1|FAULT-DOMAIN-2"}.mean()
MQL式のディメンション値に対する近似(ファジー)一致を指定します。
ファジー・照合は、MQL式でのみ使用できます。コンソールで、拡張モードを使用します。
ディメンション名と値セット間の等号(=)のかわりに、次の比較演算子を使用します。
| 比較演算子 | 説明 |
|---|---|
=~ (等号の後にチルダが続く) |
ほぼ同じ。ファジー・マッチングの使用 |
ファジー・マッチングの場合、値のセットをname = "val*"またはname = "value1|value2"のように引用符で囲みます
次の文字の1つ以上を使用して、値のセットを更新します。
| 値のファジー・マッチング文字 | 説明 |
|---|---|
* (asterisk) |
ゼロから多数の文字を示すワイルドカード。 |
|(pipe) |
ディメンション値のORオペランド。 |
3つのディメンション値セット(myshapeシェイプを使用するフォルト・ドメイン1のテスト・コンピュート・インスタンス)に対するファジー・マッチングを示す例:
CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1", resourceDisplayName =~ "test*", shape =~ "myshape"}.mean() MQL式でディメンション値をフィルタ・アウト(除外)します。
値の除外は、MQL式でのみ使用できます。コンソールで、拡張モードを使用します。
ディメンション名と値セット間の等号(=)のかわりに、次のいずれかの比較演算子を使用します。
| 比較演算子 | 説明 |
|---|---|
!= (感嘆符の後に等号が続く) |
次と等しくない。単一のディメンション値をフィルタで除外する場合に使用します。 |
!~ (感嘆符の後にチルダが続く) |
次と等しくない。複数のディメンション値をフィルタで除外するために使用します(式でワイルドカードまたはORオペランドが使用されている場合)。 |
!~比較演算子を使用する場合は、次の1つ以上の文字を使用してディメンション値のセットを更新します。
| 値のファジー・マッチング文字 | 説明 |
|---|---|
* (asterisk) |
ゼロから多数の文字を示すワイルドカード。 |
|(pipe) |
ディメンション値のORオペランド。 |
例1 (単一値): フォルト・ドメイン1を除く、CPU使用率の基本問合せ。
CpuUtilization [1m]{faultDomain != "FAULT-DOMAIN-1"}.mean()例2 (複数値): フォルト・ドメイン1および2を除く、CPU使用率の基本問合せ。
CpuUtilization [1m]{faultDomain !~ "FAULT-DOMAIN-1|FAULT-DOMAIN-2"}.mean()この項では、「メトリック・エクスプローラ」ページでディメンションを選択する方法について説明します。アラーム問合せの編集については、基本アラームの作成を参照してください。
-
MQL式を更新してディメンションを選択するには、次のステップに従います:
-
「問合せコード・エディタ」ボックスでテキストを編集します。
MQL式のディメンションの例:
CpuUtilization[1m]{faultDomain = "FAULT-DOMAIN-1"}.mean()この例では、問合により、返されるデータがフォルト・ドメイン1に制限されています。問合せおよびメトリック・チャートの例のグラフに、4つのメトリック・ストリームが表示されるようになりました。各メトリック・ストリームは、フォルト・ドメイン1のインスタンスに対応しています。
-
「問合せコード・エディタ」ボックスでテキストを編集します。
-
MQL式を更新してディメンションを選択するには、次のステップに従います:
メトリック・データを問い合せるには、oci monitoring Metric-data summary-metrics-dataコマンドおよび必須パラメータを使用します。
--query-textパラメータを使用して、ディメンション(MQL式の一部)を選択します。oci monitoring metric-data summarize-metrics-data --query-text <mql_expression> [...]CLIコマンドのパラメータおよび値の完全なリストは、モニタリングのコマンドライン・リファレンスを参照してください。
SummarizeMetricsData操作を実行して、メトリック・データを問い合せます。
query属性を使用して、ディメンション(MQL式の一部)を選択します。たとえば、SummarizeMetricsDataDetailsを参照してください。