変更追跡 (変更追跡機能) イベント

category

弦

category属性を使用すると、さまざまなcategoriesとtypesを使用して変更を分類できます。事前定義された標準のカテゴリとタイプを使用することも、独自のカスタムのものを定義することもできます。

• 標準のカテゴリとタイプを使用するには:

  • category Deploymentに設定した場合:

    • categoryFields属性をDeploymentに設定する必要があります。
    • このdeploymentフィールドにはversionが含まれている必要があります。

  • category Feature flagに設定した場合:

    • categoryFields属性をFeature flagに設定する必要があります。
    • このfeatureFlagフィールドにはfeatureFlagIdが含まれている必要があります。

• カスタム カテゴリを使用するには:

  • dataHandlingRules属性内で、 validationFlagsフィールドをALLOW_CUSTOM_CATEGORY_OR_TYPEに設定します。

type

弦

type属性は変更イベントをさらに区別するもので、多くの場合categoryと組み合わせて使用されます。たとえば、イベントのcategoryがDeploymentの場合、そのタイプはRollingになります。

通常、標準categoryに関連付けられている定義済みの標準typeを使用することも、カスタムtypeを定義することもできます。カスタム タイプを定義する場合は、次のことも行う必要があります。

• dataHandlingRules属性を設定します。
• validationFlags属性をALLOW_CUSTOM_CATEGORY_OR_TYPEに設定します。

version

弦

category

属性が

Deployment

に設定されている場合、

categoryFields

属性内で

deployment

フィールドを定義し、この

deployment

フィールドに

version

が含まれていることを確認する必要があります。

featureFlagId

弦

カテゴリとして

Feature flag

選択した場合は、

categoryFields

属性の下で

featureFlag

も選択し、

featureFlagId

を含める必要があります。この

id

には、機能フラグを識別する任意の文字列を指定できます。

dataHandlingRules

弦

カスタムのcategory 、 type 、またはcategoryとtypeの非標準の組み合わせを定義する場合は、 dataHandlingRules属性を構成する必要があります。このアクションは、 validationFlags属性をALLOW_CUSTOM_CATEGORY_OR_TYPEに設定することと結びついています。

このようなカスタム値または非標準値を使用するときにvalidationFlags ALLOW_CUSTOM_CATEGORY_OR_TYPEに設定されていない場合、 categoryまたはtype値が事前定義された標準値と完全に一致しないと、New Relic はエラーを返します。たとえば、 Deploymentなどの標準のcategoryを使用する場合でも、New Relic の標準の組み合わせではないRainbowなどのcustomタイプとペアリングするには、 validationFlagsをALLOW_CUSTOM_CATEGORY_OR_TYPEに設定し、 dataHandlingRulesを構成する必要があります。

entitySearch.query

弦

エンティティ検索クエリを使用すると、New Relic 内の特定のエンティティを見つけることができます。idフィールドを使用して特定のエンティティ GUID を使用することで、またはエンティティ GUID が不明な場合は他の識別情報を提供することで、検索できます。エンティティ guid は、計装またはセットアップ中にNew Relicアプリケーションやマイクロサービスなどのシステム コンポーネントに割り当てる一意の識別子です。 エンティティの詳細については、 New Relicエンティティ」を参照してください。

• 特定のエンティティ: idやnameなどのさまざまなプロパティで完全一致またはあいまい一致を検索できますが、厳密に 1 つのエンティティに解決できるほど具体的である必要があります。

• サポートされている演算子: エンティティ検索クエリでは、 = 、 AND 、 IN 、およびLIKEがサポートされている演算子です。

• 特殊文字の使用: ( 、 . , 、 ; 、 : 、 * 、 - 、 _ 、 )などの特殊文字は、クエリ文字列では空白文字として扱われます。たとえば、 name LIKE ':aws:'のようなクエリは、 -awsまたはfoo.awsを含むエンティティ名に一致します。

• タグ: バッククォートの有無にかかわらず、タグを参照できます。 デフォルトのエンティティ プロパティとタグに基づいてエンティティをフィルタリングできます。

  • デフォルトのエンティティ プロパティ:

    • id

    • accountId

    • name

    • domainId

    • alertSeverity

    • reporting

    • indexedAt

    • firstIndexedAt

    • lastReportingChangeAt

  • タグ: タグは、通常、より具体的なドメイン タイプまたはドメイン タイプのグループにリンクされるメタデータです。例えば：

    • language: APMアプリケーションのエージェント言語を指定します。

    • clusterAgentId: Browserアプリケーションの場合、このタグは、関連するAPMアプリケーションの葛藤にリンクします。

    • aws.accountId: AWSのインフラストラクチャ エンティティ モニターのAWS account ID 。

  例：

  • エンティティ GUID でエンティティを検索するには: "id = '<entity guid>'"
  • REST v2 APIアプリケーション ID を使用してエンティティを検索するには: "domainId = '<app id>' AND domain = 'APM'"
  • 特定のアカウントで OpenTelemetry サービスを検索するには: "name = '<service name>' AND domain = 'EXT' AND type = 'SERVICE' AND accountId = '<account id>'"

description

弦

変更追跡 (変更追跡機能) イベントの説明。 例えば：

A change event to track the marketing campaign impact.

groupId

弦

groupId属性を使用すると、1 つ以上のエンティティにわたる関連する変更を整理できます。関連する変更ごとに同じgroupIdを使用すると、New Relic インターフェースでこれらの変更をまとめて簡単に表示したり、クエリ結果を絞り込んだりすることができます。同じgroupId使用して、既存のグループに変更を追加することもできます。

shortDescription

弦

各変更の簡単な説明により、New Relic に送信された変更イベントをすぐに識別できます。空白のままにすると、エンティティ、ユーザー、バージョンを含む自動生成された説明が作成されます。短い説明は次の領域に表示されます。

• チャート上の変更マーカーにマウスを移動すると、マーカー フラグがツールヒントとして表示されます。

• Activity stream [アクティビティ ストリーム]パネル内。

  

user

弦

ユーザー ID または有効な電子メール アドレス。たとえば、ユーザー:

datanerd@example.com

。

changelog

弦

category

Deployment

に設定されている場合、オプションで

changelog

情報を含めることができます。

commit

弦

category

Deployment

に設定されている場合、オプションで

commit SHA

などの

commit

情報を含めることができます。

deepLink

弦

category

Deployment

に設定されている場合、オプションで URL などの

deepLink

を含めることができます。

タイムスタンプ

EpochMilliseconds

timestamp属性は、NerdGraph 呼び出しが受信された時刻を示します。Unix エポックからのミリ秒数を指定して変更できます。例: timestamp: 1032480000000 。

changeTrackingId

弦

changeTrackingId 、変更が記録されたときに生成される一意の識別子です。この ID を NerdGraph および NRQL クエリで使用して、特定の変更を識別できます。例: changeTrackingId: "8a3a594c-e726-4bc2-8078-26dffec9a3d8" 。

customAttributes

オブジェクト

customAttributesフィールドは、JavaScript オブジェクト形式でkey-valueペアとして指定され、値はstring 、 boolean 、またはnumber型になります。JavaScript の数値は Java longまたはdouble値として保存されます。.JSONとは異なり、JavaScript オブジェクト内のキーは引用符で囲まれません。カスタムアトリビュートを追加するには、次のように構成します。

customAttributes: {key_name : "value_name"}

先週の変更イベントを取得するには

NRQL

過去 1 か月間のアプリケーションのトランザクションエラーと変更マーカーを比較する

NRQL

過去1時間のすべてのアカウントのイベントの一覧を表示する

NerdGraph

変更イベント データを

timeWindow

、

accountIds

、およびエンティティ guid でフィルタリングするには

query

NerdGraph

クエリと制限を使用してフィルタリングする

NerdGraph