NerdGraph チュートリアル: ログデータパーティションルールの管理

NerdGraphは、 api.newrelic.com/graphiql で、データ・パーティション・ルールのログの作成、照会、管理にご利用いただけます。NerdGraphは、GraphQL形式のAPIエクスプローラーです。

データ・パーティション・ルール・スキーマ

利用可能なデータ・パーティション・ルール・フィールドは以下の通りです。

フィールド	説明
`id`	一意のデータ・パーティション・ルール識別子。
`targetDataPartition`	データパーティションの名前です。
`description`	このデータ・パーティション・ルールが何を表しているかの説明。
`matchingCriteria`	(非推奨) このデータパーティションルールの一致基準。ルールが有効になると、この条件に一致するログが指定されたデータパーティションにルーティングされます。このフィールドは推奨されておらず、データパーティションを作成する際の柔軟性を高めるために、最終的に`nrql`フィールドに置き換えられます。`matchingCriteria`に解析できない`nrql`フィールドの NRQL `WHERE`句でルールが指定されている場合、このフィールドは null になります。
`nrql`	NRQL `WHERE`句を使用して指定された、このデータパーティションルールの一致基準。ルールが有効になると、この条件に一致するログが指定されたデータパーティションにルーティングされます。
`retentionPolicy`	データ・パーティション・データのリテンション・ポリシーです。
`createdAt`	ルールが作成された日付と時間。
`createdBy`	ルールを作成したユーザー。
`updatedAt`	ルールが最後に変更された日付と時間。
`updatedBy`	ルールを最後に更新したユーザー。
`enabled`	このデータパーティションルールが有効であるかどうか。
`deleted`	このデータ・パーティション・ルールが削除されたかどうか。データ・パーティション・ルールを削除しても、すでにルーティングされたログは削除されません。

データ・パーティション・ルールのクエリ例

このNerdGraph APIリクエスト例では、指定されたアカウントのすべてのデータ・パーティション・ルールを取得します。この例では、いくつかのフィールドのみをリクエストしています。

{
  actor {
    account(id: 123456) {
      logConfigurations {
        dataPartitionRules {
          id
          targetDataPartition
          description
          nrql
          matchingCriteria {
            attributeName
            matchingOperator
            matchingExpression
          }
        }
      }
    }
  }
}

nrql where 句を使用してデータパーティションルールを作成する

この例では、新しいデータ・パーティション・ルールを作成します。ルールを作成する前に、 organizing data with partitions についてのドキュメントを確認してください。

mutation {
  logConfigurationsCreateDataPartitionRule(
    accountId: 1123456
    rule: {
      targetDataPartition: "Log_aNewDataPartitionRule"
      description: "Example data partition rule"
      nrql: "attrbute = 'value'"
      retentionPolicy: STANDARD
      enabled: true
    }
  ) {
    rule {
      id
      targetDataPartition
      description
    }
    errors {
      message
      type
    }
  }
}

matchingCriteria を使用してデータパーティションルールを作成する (非推奨)

この例では、新しいデータパーティションルールを作成します。ルールを作成する前に、パーティションを使用したデータの整理に関するドキュメントを必ず確認してください。 matchingCriteriaフィールドは廃止され、 nrqlが優先され、最終的に削除される予定です。

mutation {
  logConfigurationsCreateDataPartitionRule(
    accountId: 1123456
    rule: {
      targetDataPartition: "Log_aNewDataPartitionRule"
      description: "Example data partition rule"
      matchingCriteria: {
        attributeName: "attribute"
        matchingMethod: LIKE
        matchingExpression: "'%example%'"
      }
      retentionPolicy: STANDARD
      enabled: true
    }
  ) {
    rule {
      id
      targetDataPartition
      description
    }
    errors {
      message
      type
    }
  }
}

nrql where 句を使用してデータパーティションルールを更新する

この例では、指定された ID "123"でデータパーティションルールを更新します。更新できるフィールドはdescription 、 nrql 、およびenabledです。それらはすべてオプションなので、更新したいものだけを使用する必要があります。

mutation {
  logConfigurationsUpdateDataPartitionRule(
    accountId: 1123456
    rule: {
      id: "123"
      description: "Example data partition rule"
      nrql: "attribute LIKE '%example%'"
      enabled: true
    }
  ) {
    rule {
      id
      targetDataPartition
      description
    }
    errors {
      message
      type
    }
  }
}

データ・パーティション・ルールの更新

この例では、指定された ID "123"でデータパーティションルールを更新します。更新できるフィールドはdescription 、 matchingCriteria 、およびenabledです。それらはすべてオプションなので、更新したいものだけを使用する必要があります。

mutation {
  logConfigurationsUpdateDataPartitionRule(
    accountId: 1123456
    rule: {
      id: "123"
      description: "Example data partition rule"
      matchingCriteria: {
        attributeName: "attribute"
        matchingMethod: LIKE
        matchingExpression: "'%example%'"
      }
      enabled: true
    }
  ) {
    rule {
      id
      targetDataPartition
      description
    }
    errors {
      message
      type
    }
  }
}

データパーティションの削除ルール

この例では、データパーティションルールを削除します。データパーティションルールを削除しても、既にパーティション分割されているデータは削除されません。そのデータは、 retentionPolicyフィールドで定義された一定期間保持されます。

mutation {
  logConfigurationsDeleteDataPartitionRule(id: "1111", accountId: 123456) {
    errors {
      message
      type
    }
  }
}

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

NerdGraph チュートリアル: ログ データ パーティション ルールの管理

データ・パーティション・ルール・スキーマ .css-21sua1{background:none;border:none;width:0;padding:0;}