NerdGraphチュートリアル：メトリクス正規化ルールの管理

プレビュー

この機能はまだ開発中ですが、ぜひお試しください。この機能は現在、弊社のプレリリースポリシーに従ってプレビュープログラムの一部として提供されています。

NerdGraphのミューテーションを使用して、New Relicのメトリクス正規化ルールを管理できます。これらのミューテーションを活用することで、New Relicアカウントから直接、これらのルールを作成、編集、有効化、および無効化できます。これにより、メトリクスグループ化の問題（MGI）を解決するための合理的かつプログラムによるアプローチが提供されます。

メトリクス正規化ルールは、次の目的で使用されます：

メトリックタイムスライスデータをグループ化または除外します。
New Relicに取り込まれる前に、名前の変更、破棄、または変換を行って、高いカーディナリティのメトリクスを管理します。
メトリクスを適切に整理して意味のある状態に保つために、MGIを防止します。
New Relicに報告される一意のメトリクス名の数を減らします。

前提条件

New Relicアカウント。そのアカウントでは、クエリやミューテーションに含める必要があるAPIユーザーキーにアクセスできます。
ユーザータイプと割り当てられたロールは、NerdGraphの権限に影響を与える可能性があります。詳細については、アクセスに影響する要因を参照してください。

ヒント

New Relicプラットフォームを使用して、メトリクス正規化ルールを作成することもできます。詳細については、「メトリクス正規化ルール」を参照してください。

メトリクス正規化ルールを取得する

アカウントに関連付けられているすべてのメトリクス正規化ルールを取得するには、metricNormalizationRulesクエリを使用してください。このクエリは、ステータスや設定を含む、既存のルールの包括的な概要を提供します。

入力

属性名	データ型	説明
`accountId`	弦	（必須）ルールに関連付けられたアカウントID。
`enable`	ブール値	（必須）`true`に設定されている場合、有効なルールのみが返されます。

サンプルクエリ

{
  actor {
    user {
      name
    }
    account(id: xxxxxx) {
      metricNormalization {
        metricNormalizationRules(enabled: true) {
          action
          applicationGuid
          applicationName
          createdAt
          enabled
          evalOrder
          id
          matchExpression
          notes
          replacement
          terminateChain
        }
      }
    }
  }
}

変異

以下のNerdGraphミューテーションを使用して、メトリクス正規化ルールを管理します：

metricNormalizationCreateRuleミューテーションを使用して、New Relicで新しいメトリクス正規化ルールを作成します。

入力

属性名	データ型	説明
アカウントID	弦	（必須）ルールに関連付けられたアカウントID。
アクション	弦	（必須）以下のアクションのいずれかを選択してください。 `REPLACE`：`matchExpression`に一致するメトリクスを、`replacement`フィールドで定義された値に置き換えます。 `IGNORE`：`matchExpression`に一致するメトリクスがNew Relicに報告されるのをブロックします。 `DENY_NEW_METRICS`：`matchExpression`に一致する新しいメトリクス名の作成を防ぎつつ、既存のメトリクス名は引き続き報告できるようにします。
applicationGuid	弦	（任意）New Relicにおけるアプリケーションの一意のGUID。空白のままにした場合、これはアカウント全体のルールになります。
有効	ブール値	（必須）ルールを有効にするには、`true`に設定します。
evalOrder	整数	（必須）他のルールに対して、ルールが適用される順序を指定します。数値が小さいほど、評価の優先度が高くなります。推奨値は`2000`です。
matchExpression	弦	（必須）正規化対象のメトリクスに一致する正規表現パターンを受け入れます。このフィールドは`^`で始まり、`$`で終わる必要があります。正規化ルールの影響を受けるメトリクスを特定するためのパターンを定義します。例：`^WebTransaction/Uri/RESTfulExample/users/username/[a-zA-Z0-9]+$` パターン`^[a-zA-Z0-9]+$`は、小文字`(a-z)`、大文字`(A-Z)`、および数字`(0-9)`で構成される任意の文字列に一致します。
メモ	弦	正規化ルールに関する追加のメモまたはコメント。
置換	弦	このフィールドは、`action`ドロップダウンリストから`REPLACE`オプションが選択されている場合にのみ必須です。`matchExpression`に一致するすべてのメトリクス名を置き換えます。例を以下に示します。 `WebTransaction/Uri/RESTfulExample/users/username/{username}$`
terminateChain	ブール値	（必須）`true`に設定されている場合、一致したメトリクスにはこれ以上のルールは適用されません。

サンプルクエリ

mutation {
  metricNormalizationCreateRule(
    accountId: xxxxxx
    rule: {
      action: REPLACE
      applicationGuid: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      enabled: false
      evalOrder: 2000
      matchExpression: "^WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/[a-f0-9]+$"
      notes: "rules to replace"
      replacement: "WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/{guid}"
      terminateChain: true
    }
  ) {
    errors {
      message
      type
    }
    rule {
      action
      applicationGuid
      applicationName
      createdAt
      enabled
      evalOrder
      id
      matchExpression
      notes
      replacement
      terminateChain
    }
  }
}

サンプル回答

{
        "data": {
            "metricNormalizationCreateRule": {
                "errors": [],
                "rule": {
                    "action": "REPLACE",
                    "applicationGuid": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                    "applicationName": "MetricGroupingIssue",
                    "createdAt": 1743641443000,
                    "enabled": false,
                    "evalOrder": 2000,
                    "id": 29205,
                    "matchExpression": "^WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/[a-f0-9]+$",
                    "notes": "rules to replace",
                    "replacement": "WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/{guid}",
                    "terminateChain": true
                }
            }
        }
    }

ruleIdパラメーターを使用して既存のルールの値を更新するには、metricNormalizationEditRuleミューテーションを使用します。これにより、新しいインサイトや変化する要件に合わせてルールを調整する柔軟性が提供されます。Retrieve the metric normalization rulesクエリを使用して、ruleId情報を取得できます。

入力

属性名	データ型	説明
アカウントID	弦	（必須）ルールに関連付けられたアカウントID。
アクション	弦	（必須）以下のアクションのいずれかを選択してください。 `REPLACE`：`matchExpression`に一致するメトリクスを、`replacement`フィールドで定義された値に置き換えます。 `IGNORE`：`matchExpression`に一致するメトリクスがNew Relicに報告されるのをブロックします。 `DENY_NEW_METRICS`：`matchExpression`に一致する新しいメトリクス名の作成を防ぎつつ、既存のメトリクス名は引き続き報告できるようにします。
applicationGuid	弦	（任意）New Relicにおけるアプリケーションの一意のGUID。空白のままにした場合、これはアカウント全体のルールになります。
有効	ブール値	（必須）ルールを有効にするには、`true`に設定します。
evalOrder	整数	（必須）他のルールに対して、ルールが適用される順序を指定します。数値が小さいほど、評価の優先度が高くなります。推奨値は`2000`です。
id	弦	（必須）値を更新するメトリクスルールの`ruleId`。
matchExpression	弦	（必須）正規化対象のメトリクスに一致する正規表現パターンを受け入れます。このフィールドは`^`で始まり、`$`で終わる必要があります。正規化ルールの影響を受けるメトリクスを特定するためのパターンを定義します。例：`^WebTransaction/Uri/RESTfulExample/users/username/[a-zA-Z0-9]+$` パターン`^[a-zA-Z0-9]+$`は、小文字`(a-z)`、大文字`(A-Z)`、および数字`(0-9)`で構成される任意の文字列に一致します。
メモ	弦	正規化ルールに関する追加のメモまたはコメント。
置換	弦	このフィールドは、`action`ドロップダウンリストから`REPLACE`オプションが選択されている場合にのみ必須です。`matchExpression`に一致するすべてのメトリクス名を置き換えます。例を以下に示します。 `WebTransaction/Uri/RESTfulExample/users/username/{username}$`
terminateChain	ブール値	（必須）`true`に設定されている場合、一致したメトリクスにはこれ以上のルールは適用されません。

サンプルクエリ

mutation {
  metricNormalizationEditRule(
    accountId: xxxxx
    rule: {
      id: 29205
      notes: "rules to replace"
      matchExpression: "^WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/[a-f0-9]+$"
      action: REPLACE
      enabled: false
      replacement: "WebTransaction/Uri/MGIGenerator_war_exploded/api/MGI/pattern/{guid}"
    }
  ) {
    errors {
      message
      type
    }
    rule {
      action
      applicationGuid
      applicationName
      createdAt
      enabled
      evalOrder
      id
      matchExpression
      notes
      replacement
      terminateChain
    }
  }
}

以前に無効にされたルールを有効にするには、accountIdおよびruleIdパラメーターを指定してmetricNormalizationEnableRuleミューテーションを使用します。Retrieve the metric normalization rulesクエリを使用して、これらのパラメーターを取得できます。

入力問題

属性名	データ型	説明
アカウントID	弦	（必須）ルールに関連付けられたアカウントID。
ruleId	弦	（必須）メトリクスルールの`ruleId`。

クエリの例

mutation {
  metricNormalizationEnableRule(accountId: xxxxxx, ruleId: 29205) {
    errors {
      message
      type
    }
    rule {
      action
      applicationGuid
      applicationName
      createdAt
      enabled
      evalOrder
      id
      matchExpression
      notes
      replacement
      terminateChain
    }
  }
}

accountIdおよびruleIdパラメーターを使用して、以前に有効化されたルールを無効にするには、metricNormalizationDisableRuleミューテーションを使用します。Retrieve the metric normalization rulesクエリを使用して、これらのパラメーターを取得できます。

入力問題

属性名	データ型	説明
アカウントID	弦	（必須）ルールに関連付けられたアカウントID。
ruleId	弦	（必須）メトリクスルールの`ruleId`。

クエリの例

mutation {
  metricNormalizationDisableRule(accountId: xxxxxx, ruleId: 29205) {
    errors {
      message
      type
    }
    rule {
      action
      applicationGuid
      applicationName
      createdAt
      enabled
      evalOrder
      id
      matchExpression
      notes
      replacement
      terminateChain
    }
  }
}

この機械翻訳は、参考として提供されています。

NerdGraphチュートリアル：メトリクス正規化ルールの管理

プレビュー

前提条件

ヒント

メトリクス正規化ルールを取得する

入力

サンプルクエリ

変異

メトリクス正規化ルールを作成する

入力

サンプルクエリ

サンプル回答

メトリクス正規化ルールの編集

入力

サンプルクエリ

メトリクス正規化ルールを有効にする

入力問題

クエリの例

メトリクス正規化ルールを無効にする

入力問題

クエリの例

この機械翻訳は、参考として提供されています。

NerdGraphチュートリアル：メトリクス正規化ルールの管理

プレビュー

前提条件 .css-21sua1{background:none;border:none;width:0;padding:0;}

ヒント

メトリクス正規化ルールを取得する

入力

サンプルクエリ

変異

メトリクス正規化ルールの編集

メトリクス正規化ルールを有効にする

メトリクス正規化ルールを無効にする

前提条件