データの取り込みを管理する1 つの方法は、 Pipeline Control cloudルールを使用することです。 Pipeline cloudルールを作成するには、 New Relicの使用量ベースの価格設定を使用する必要があります。

作成できるルールには 2 つのカテゴリがあります。

データ削除ルール
- 次の形式の NRQL を使用して、アクションを使用して、データ型全体またはデータ サブセット(オプションのフィルターを使用) をドロップします。Drop data
  DELETE FROM DATA_TYPE_1, DATA_TYPE_2 (WHERE OPTIONAL_FILTER)
属性ルールの削除
- アクション を使用して、データ型から属性を削除します(オプションのフィルターを使用)* *Drop attributes。NRQL は次の形式です。
  DELETE dropAttr1, dropAttr2 FROM DATA_TYPE (WHERE OPTIONAL_FILTER)
- このタイプのルールでは、 SELECT句に生の属性名の空でないリストを渡す必要があります。

ヒント

Pipeline Control cloudルールは、ルールを作成した瞬間から到着するデータにのみ適用され、すでに取り込まれたデータは削除されません。

課金対象としてカウントされるデータと課金対象としてカウントされないデータの詳細については、「データ取り込み」を参照してください。

クラウドルールのデータ範囲

cloudルールを使用して、次のデータタイプを対象にします。

APMで報告されたイベント
ブラウザで報告されるイベント
モバイルで報告されたイベント
シンセティック・レポート・イベント
カスタムイベント（ APMエージェントAPI や Event API で生成されるようなもの）。
ログデータ（UIを使ってデータをドロップすることも可能です )
* トレーススパンの分散
 デフォルトのインフラストラクチャ監視イベントとインフラストラクチャ統合イベント。いくつかの注意事項:
- このデータを削除すると、生データは削除されますが、集約されたSystemSample 、 ProcessSample 、 NetworkSample 、およびStorageSampleイベントは引き続き利用できます (詳細については、「データ保持期間」を参照してください)。このデータは引き続き利用可能ですが、取り込みにはカウントされず、課金対象にはなりません。
- 生のインフラストラクチャデータはアラートに使用されるため、そのデータをドロップした場合、そのデータについてアラートを発行することはできません。集計されたデータは引き続き利用できるため、59 分を超える時間範囲のデータがグラフに表示される場合があります。
次元メトリックス。注意点:
- イベント-to-メトリクスサービスによって生成されたメトリクスの場合: クラウドルールは機能しませんが、イベント-to-メトリクスルールを無効にするか再構成することで、これらのメトリクスを停止したり、プロパティを削除したりできます。
- メトリックタイムスライスデータはcloudルールでは削除できません。 APMメトリックタイムスライスデータの詳細については、このドキュメントを参照してください。

NRQL制限

NRQL クエリの長さの制限は4096文字です。長さを超えると、 INVALID_NRQL_TOO_LONGエラーが発生します。分割できない長いクエリに基づいてデータを削除する必要がある場合は、 New Relic サポートにお問い合わせください。
JOIN サブクエリはサポートされていません。
特定の属性を持つデータを選択するには、 WHERE句を指定できます。
LIMIT 、 TIMESERIES 、 COMPARE WITH 、 FACETなどの機能やその他の句は使用できません。
SINCE UNTILはサポートされていません。時間固有のルールがある場合（たとえば、将来のある時点まですべてをドロップするなど）、 WHERE timestamp < (epoch milliseconds in the future)を使用します。
SINCEを使用して履歴データを削除することはできません。クラウドルールは、ルールの作成後に報告されたデータにのみ適用されます。すでに報告されているデータを削除する必要がある場合は、「既存のデータの削除」を参照するか、 New Relic サポートにお問い合わせください。

監査ルールの履歴

誰がcloudルールを作成および削除したかを確認するには、アカウント監査ログを作成します。リストエンドポイントには、ルールを作成したユーザーのユーザー ID も含まれます。

データを落とす際の注意点

クラウドルールは各データポイントに個別に適用されます。たとえば、次の 3 つのデータドロップルールを見てみましょう。

重要

ルールを作成するときは、設定した条件を満たすデータをルールが正確に識別して破棄するようにする責任があります。また、ルールと New Relic に開示するデータを監視する責任も負います。

1. DELETE FROM MyEvent WHERE myAttr not in ('staging')
2. DELETE FROM MyEvent WHERE myAttr not in ('production')
3. DELETE FROM MyEvent WHERE myAttr in ('development')

これらの 3 つのルールは各データポイントに個別に適用されます。要約すると、任意の値を持つmyAttrを含むすべてのMyEventイベントが削除されます。

myAttr: 'staging' -> ルール2に一致
myAttr: 'production' -> ルール 1 に一致
myAttr: 'development' -> ルール1、2、3に一致
myAttr: 'uuid-random-string' -> ルール1と2に一致

New Relic は、この機能によってデータ漏洩に関する懸念が完全に解決されることを保証することはできません。New Relic開発したルールの有効性をレビューしたり監視したりしません。常にクエリをテストおよび再テストし、ドロップルールの作成後に意図したとおりに動作することを確認してください。

センシティブなデータに関するルールを作成すると、どのような種類のデータを保持しているのか、データやシステムの形式（例えば、電子メールアドレスや特定のクレジットカード番号を参照することなど）などの情報が漏れてしまいます。作成したルールは、そのルールに含まれるすべての情報を含めて、関連するロールベースのアクセス制御権限を持つすべてのユーザーが表示および編集できます。

ドロップされるのは新規データのみです。既存のデータの編集や削除はできません。

cloudルールの管理

ルールを作成および編集するには、 Pipeline Control UIまたはNerdGraph API エクスプローラー( one.newrelic.com > Apps > NerdGraph API explorer )を使用できます。

注意

データを削除する場合は注意が必要です。落としたデータは復元できません。潜在的な問題の詳細については、「注意事項」を参照してください。

ユースケースの例

重要ではないイベントタイプが New Relic に送信されていることに気付いたとします。また、ソースがこれらのイベントタイプを送信するのを迅速に停止することは非現実的であり、エージェントやAPI計装の変更が必要になります。 cloudルールを使用すると、同じ目的をより簡単に達成できます。

これは、 Event1とEvent2の2つのイベントタイプをドロップするNerdGraph呼び出しの例です。

mutation {
  entityManagementCreatePipelineCloudRule(
    pipelineCloudRuleEntity: {
      description: "Event1 and Event2 are unimportant, see ticket DM-1234"
      name: "Drop all data for Event1 and Event2"
      nrql: "DELETE FROM Event1, Event2"
      scope: { id: "your_nr_account_id", type: ACCOUNT }
    }
  ) {
    entity {
      id
      name
      nrql
    }
  }
}

複数のソースから届く大量のカスタムイベントタイプがあるとします。すべてのデータが重要ではない場合は、 cloudルールを使用できます。以下は、特定の基準に基づいてイベントをフィルタリングするcloudルールの例です。

mutation {
  entityManagementCreatePipelineCloudRule(
    pipelineCloudRuleEntity: {
      description: "Drops all data for MyCustomEvent that comes from the LoadGeneratingApp in the dev environment, because there is too much and we don’t look at it"
      name: "Drop MyCustomEvent from LoadGeneratingApp in dev"
      nrql: "DELETE FROM MyCustomEvent WHERE appName='LoadGeneratingApp' AND environment='development'"
      scope: { id: "your_nr_account_id", type: ACCOUNT }
    }
  ) {
    entity {
      id
      name
      nrql
    }
  }
}

イベントに個人を特定できる情報 (PII) を含む属性があることに気付いたとします。データの送信を停止するためにサービスを更新中ですが、それまでは、New Relic にこれ以上の PII を保存しないようにする必要があります。Drop dataを使用すると、入ってくるデータをすべて削除できますが、残りのデータは依然として価値を提供します。したがって、問題のある PII のみをデータから削除するcloudルールを登録できます。

mutation {
  entityManagementCreatePipelineCloudRule(
    pipelineCloudRuleEntity: {
      description: "Removes the user name and email fields from MyCustomEvent"
      name: "Drop username and email from MyCustomEvent"
      nrql: "DELETE userName, userEmail FROM MyCustomEvent"
      scope: { id: "your_nr_account_id", type: ACCOUNT }
    }
  ) {
    entity {
      id
      name
      nrql
    }
  }
}

ルールが機能することを確認する

cloudルールを作成したら、期待どおりに動作しているかどうかを確認することをお勧めします。登録が成功するとすぐにルールが有効になるはずなので、登録したクエリのTIMESERIESバージョンを実行して、データが削除されるかどうかを確認してください。

注: 時系列データは、イベント時間 (処理時間ではない) を x 軸としてレンダリングされます。New Relic は最大 24 時間先のタイムスタンプを持つデータを受け入れるため、ルールが作成される前に New Relic に送信されたが、イベントタイムスタンプがルール作成後のデータが表示される場合があります。

クラウドルールタイプ	NRQL
`Drop data`	Cloud rule NRQL: `DELETE FROM MyEvent WHERE foo = bar` Validation NRQL: `SELECT count(*) FROM MyEvent WHERE foo = bar TIMESERIES` これは0に低下するはずです。他に影響がないことを確認するには、 `WHERE`句を逆にします。
`Drop attributes`	Cloud rule NRQL: `DELETE dropAttr1, dropAttr2 FROM MyEvent WHERE foo = bar` Validation NRQL: `SELECT count(dropAttr1), count(dropAttr2) FROM MyEvent WHERE foo = bar TIMESERIES` 両方の行が0にドロップする必要があります。これらの属性を含むイベントに影響がなく、それでも影響がないことを確認するには、 `WHERE`句を逆にします。

クラウドルールタイプ

NRQL

Drop data

Cloud rule NRQL:

DELETE FROM MyEvent WHERE foo = bar

Validation NRQL:

SELECT count(*) FROM MyEvent WHERE foo = bar TIMESERIES

これは0に低下するはずです。他に影響がないことを確認するには、 WHERE句を逆にします。

Drop attributes

Cloud rule NRQL:

DELETE dropAttr1, dropAttr2 FROM MyEvent WHERE foo = bar

Validation NRQL:

SELECT count(dropAttr1), count(dropAttr2) FROM MyEvent WHERE foo = bar TIMESERIES

両方の行が0にドロップする必要があります。これらの属性を含むイベントに影響がなく、それでも影響がないことを確認するには、 WHERE句を逆にします。

NerdGraphの例

cloudルールを作成する

ドロップデータ:

mutation {
  entityManagementCreatePipelineCloudRule(
    pipelineCloudRuleEntity: {
      description: "Since we only care about MyEvent in staging and production, let's drop all MyEvent data in the test environment"
      name: "Drop MyEvent in test environment"
      nrql: "DELETE FROM MyEvent where environment = 'test'"
      scope: { id: "your_nr_account_id", type: ACCOUNT }
    }
  ) {
    entity {
      id
      name
      nrql
    }
  }
}

ドロップ属性:

mutation {
  entityManagementCreatePipelineCloudRule(
    pipelineCloudRuleEntity: {
      description: "Since we only care about MyEvent in staging and production, let's drop all MyEvent data in the test environment"
      name: "Drop MyEvent in test environment"
      nrql: "DELETE jvmId, targetAttr FROM MyEvent where environment = 'test'"
      scope: { id: "your_nr_account_id", type: ACCOUNT }
    }
  ) {
    entity {
      id
      name
      nrql
    }
  }
}

cloudルールを削除する

mutation {
  entityManagementDelete(
    id: "MTAyNTY1MHxOR0VQfFBJUEVMSU5FX0NMT1VEX1JVTEV8MDE5NWI0NDYtNjk5My03NGE5LWEyYjktMzBjMzQ1ODM0NTUz"
  ) {
    id
  }
}

cloudルールを表示

単一のcloudルールを取得します。

{
  actor {
    entityManagement {
      entity(
        id: "MTAyNTY1MHxOR0VQfFBJUEVMSU5FX0NMT1VEX1JVTEV8MDE5NWI0M2UtYmFhNy03NDk3LWI0N2ItNjUyMmEzZDFmZTFi"
      ) {
        id
        ... on EntityManagementPipelineCloudRuleEntity {
          id
          name
          description
          nrql
          metadata {
            createdBy {
              id
            }
            createdAt
          }
        }
      }
    }
  }
}

すべてのcloudルールを一覧表示します。

{
  actor {
    entityManagement {
      entitySearch(query: "type = 'PIPELINE_CLOUD_RULE'") {
        entities {
          id
          type
          ... on EntityManagementPipelineCloudRuleEntity {
            id
            name
            nrql
          }
          metadata {
            createdBy {
              id
            }
          }
        }
      }
    }
  }
}

ドロップできないイベントと属性

cloudルールを使用して次のイベントとプロパティを削除することはできません:

イベントタイプ	説明
`NrAuditEvent`	削除できない API の使用に関する重要な監査情報。
`NrIntegrationError`	お客様と New Relic 間の問題に関する重要な情報。

属性	説明
任意の `nr.` 接頭辞属性	New Relic内部で使用
`timestamp`	すべてのデータタイプに不可欠
`appId`	すべてのデータタイプに不可欠
`metricName`	メトリクスデータ型に統合
`instrumentation.provider`	請求および使用状況データに使用されます

もっと詳しく知る

もっと知りたい方へのおすすめ情報

NerdGraphの基礎知識と用語集
NRQLの基礎知識
ルールに関するコミュニティのディスカッションについては、サポートフォーラムを参照してください。cloud
複雑な組織のデータ取り込みの管理の詳細については、データ取り込みガバナンスを参照してください。

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

Pipeline Control cloudルールを使用してデータをドロップする

ヒント