メトリクス変換ルール

最後の更新
PDFとして保存

メトリクス変換ルールにより、未処理のメトリクスを保持する期間を制御できます。収集時にメトリクスを集計し、集計されたメトリクスの保持期間を別々に指定することもできます。

メトリクス変換ルールは、次の場合に役立ちます。

一時的な高カーディナリティデータの保存を 8 日間に限定する必要があり、さらに長期の保存や傾向分析のためにメトリクスを集計してビジネスレベル KPI を得る必要がある場合。
開発環境とテスト環境のメトリクスの保存を 8 日間に限定する必要があり、それ以降は保存する必要性がない場合。
生のメトリクスを事前に集計して、クエリのパフォーマンスを改善し、生のメトリクスをまったく保持しないようにする場合。

メトリクス変換ルールについての重要事項

メトリクス変換ルールは、ルールに定義したセレクタに一致するメトリクスに適用されます。メトリクスクエリのタブにセレクタを入力することで、影響を受けるメトリクスを確認できます。
ルールセレクタに一致するメトリクスを Sumo で保持する期間は、短縮できます。デフォルトでは、メトリクスが 400 日保持されます。変換ルールでは、セレクタに一致するメトリクスの保持期間を 8 日に設定できます。
必要に応じて、セレクタに一致するメトリクスを 1 つ以上のディメンションで集計できます。メトリクスを集計する場合には、次のことが可能です。
- 集計するメトリクスの保持期間に 8 日と 400 日のいずれかを指定できます。
- 生 (未集計) のメトリクスの保持期間はゼロに減らすことができます。この場合、Sumo ではメトリクスが集計され、生のメトリクスが破棄されます。
- 集計されたメトリクスの (複数の) ディメンションは、mustache テンプレートを使用して変換できます。たとえば、メトリクスが集計されたことを示す接尾辞を取り込むメトリクスディメンションを変換できます。これにより、生のメトリクスと集計されたメトリクスの区別が容易になります。

制限事項

メトリクスの変換ルールは、Sumo アカウントごとに最大 50 個作成できます。
メトリクスルールによって作成されたタグをメトリクス変換ルールのセレクタで使用することはできません。
新規または更新されたメトリクス変換ルールが有効になるまで、最大 5 分かかります。
変換ルールによって作成されたメトリクスについてアラートを出すことはできません。
メトリクスルールによって作成されたメトリクスを別の変換ルールのセレクタで使用することはできません。

メトリクス変換ルールの作成

[Manage Data (データの管理)] > [Settings (設定)] > [Metrics Transformation Rules (メトリクス変換ルール)] に移動します。
[Add (追加)] をクリックします。
[Add a Rule (ルールの追加)] ペインが表示されます。
Name (名前): メトリクス変換ルールの名前。
Selector (セクレタ): 変換ルールの適用先メトリクスを照合するセレクタ。(メトリクスクエリの範囲)。
Retention (保持期間): セレクタに一致するメトリクスを保持する期間。利用可能なオプションは次のとおりです。
- Do Not Store (保持しない): このオプションは、次の [Aggregate on (集計オン)] セクションで 1 つ以上の集計ディメンションを指定するまで表示されません。(これは、生のメトリクスが、集計されていない場合に、削除されないようにするためです)。
- 400 日間
- 8 日間
Aggregate On (集計オン): (省略可能) 1 つ以上のディメンションで生のメトリクスを集計する場合は、[+Add (+追加)] をクリックしてディメンション名を入力します。Sumo では、取り込み時に、集計済みのメトリクスがすべてのロールアップタイプ (avg、min、max、sum、および count) について 1 分および 1 時間の精度で量子化されます。
生のメトリクスは、最大 10 個のディメンションで集計できます。
Aggregate Retention (集計の保持): (集計のディメンションを入力した場合は必須)。集約されたメトリクスの保持期間。利用可能なオプションは次のとおりです。
- 400 日
- 8 日
Transformations (変換): (省略可能) 新しいディメンションを追加する場合や、集計されたメトリクスのディメンションを変換する場合は、[+Add (+追加)] をクリックします。
1. Dimension to replace or add (置換または追加するディメンション): 変換するディメンションを入力します。次に例を示します。
  metric
2. Value (値): ディメンションの新しい名前を入力するか、mustache テンプレートを使用して新しいディメンション名の形式を指定します。次に例を示します。
  {{metric}}_agg_by_service
  集計済みメトリクスのメトリクスディメンションが次の場合について考えます。
  
  container_memory_usage_byte
  
  上記の mustache テンプレートは、メトリクスディメンションを次のように変換します。
  
  container_memory_usage_byte_agg_by_svc
  - mustache テンプレートを使用して、追加または置換するディメンションの名前の形式を指定する場合、最大 10 個のテンプレートを使用できます。
  - メトリクス変換ルールは、10 個の変換に制限されています。
  - 変換されたディメンションに割り当てる名前、および変換されたディメンションに返される値は、それぞれ 4096 文字に制限されています。ディメンションのキーまたは値が 4096 文字を超える場合、Sumo ではキーまたは値が切り捨てられ、最初の 4096 文字のみが保持されます。
[Save (保存)] をクリックします。

メトリクス変換ルールの編集

[Manage Data (データの管理)] > [Settings (設定)] > [Metrics Transformation Rules (メトリクス変換ルール)] に移動します。
編集するルールをクリックします。
右側のペインで [Edit (編集)] をクリックします。

メトリクス変換ルールの削除

[Manage Data (データの管理)] > [Settings (設定)] > [Metrics Transformation Rules (メトリクス変換ルール)] に移動します。
削除するルールをクリックします。
右側のペインで [Delete (削除)] をクリックします。

メトリクス変換ルールの例

メトリクスの保持を 8 日間に変更する

開発環境から収集したメトリクスが必要になるのは、収集後 1 週間だけであると仮定します。キーが「environment」で値が「dev」のディメンションを使用して、開発環境のメトリクスにタグを付けます。ルールを次のように設定します。

Selector (セクレタ): 以下を入力します。
environment=dev
Retention (保持期間)。プルダウンリストから [8 days] を選択します。

セレクタ environment=dev に一致するすべてのメトリクスは 8 日間保持され、その後削除されます。集計は省略可能であるため、それらは集計されません。この場合は、単純に変換ルールを使用して、メトリクスを保持する期間を制御します。Sumo Logic ではデフォルトで、メトリクスが 400 日保持されます。このようなルールでは、メトリクスの保持期間を 8 日間に短縮できます。

長期の傾向分析に対応する高いカーディナリティのデータと一時的なデータの集計

変換ルールを使用して、一時的な Source の高カーディナリティデータを集計し、長期にわたって分析することができます。コンテナメトリクスは、このようなデータの 1 つの例です。コンテナは一時的なものであり、必要に応じて作成および破棄されるため、存続期間の短い時系列が大量に発生します。たいていの場合、コンテナレベルのメトリクスは長期的には役に立ちません。ただし、サービスまたはデプロイレベルで集計されるコンテナメトリクスは、長期的な傾向分析に大いに役立つ場合があります。

このルールの動作は次のとおりです。

ルールは、セレクタ metric=container_* に一致するメトリクスに適用されます。 (名前が「container_」で始まるメトリクス)。この例では、次のメトリクスが一致すると仮定します。
metric=container_memory_usage_bytes service=foo container=1234 pod=abcd metric=container_memory_usage_bytes service=foo container=4321 pod=dcba metric=container_fs_bytes service=foo container=1234 pod=abcd metric=container_fs_bytes service=foo container=4321 pod=dcba
上の一致したメトリクスは 8 日間保持され、その後破棄されます。
一致する指標は metric と service ディメンションによって集計されます。集計されたメトリクスは、すべてのロールアップタイプ (avg、min、max、sum、および count) について 1 分および 1 時間の精度で量子化されます。
上の集計されたメトリクスは 400 日間保持され、その後破棄されます。
生のメトリクスの集計に使用されたディメンションのみが、集計されるメトリクスで保持されます。container および pod ディメンションは集計されるメトリクスには取り込まれません。
集計されたメトリクスのメトリクスディメンションの値は、次のように接尾辞「_agg」を持つように変更されます。
metric=container_memory_usage_bytes_agg service=foo metric=container_fs_bytes_agg service=foo

テンプレートによって推奨されるタグ: 記事: トピック