プレビュー
この機能はまだ開発中ですが、ぜひお試しください。
この機能は現在、弊社のプレリリース ポリシーに従ってプレビューの一部として提供されています。
変更追跡 (変更追跡機能) 機能を使用すると、アプリケーションとインフラストラクチャ全体の変更をキャプチャ、視覚化、分析できます。 この機能は、変更がシステムと顧客の両方にどのような影響を与えるかを理解できるように設計されています。
システムに影響を与えるすべての変更をキャプチャする:機能フラグの変更、設定の変更、ビジネス イベントなど、あらゆるタイプの変更について変更イベントを送信します。 特定の要件に合わせてカスタム変更イベントを作成することもできます。changeTrackingCreateEvent NerdGraph ミューテーションを使用すると、さまざまな種類の変更イベントを簡単に送信できます。
システム全体の変更を管理するための包括的なビューを取得します。1つの統合インターフェースから、すべてのエンティティとアカウントにわたる変更イベントをシームレスに表示およびフィルタリングします。チーム、タイプ、カスタムアトリビュート、その他の基準でフィルタリングすることで、変更を簡単に特定します。
変更をテレメトリと素早く相関させて根本原因の発見を加速:変更イベントを時系列データとともに視覚化することで、変更の影響をより深く理解できます。 根本原因をより早く見つけるには、時系列の書き込みを追加して、関連するメトリクスとの変化イベントを表示し、明確な相関関係を可能にします。
包括的なメタデータで変更イベントを充実させる:カスタムアトリビュート、カテゴリ、タイプを使用して、変更に関する必要な情報をすべて追跡します。 システムの徹底的な明確化に必要なすべての詳細が含まれるように変更イベントをカスタマイズします。
New Relicの変更追跡 (変更追跡機能) ページにアクセスします
Change Trackingページには、次の方法でアクセスできます。
すべてのエンティティ ページにわたる変更追跡 (変更追跡機能)
すべてのエンティティのChange Trackingページには、すべてのアカウントとエンティティの変更イベントの統合ビューが 1 つのページに表示されます。これにより、次のことが可能になります。
- アクセス可能なすべてのアカウントとエンティティにわたる変更を確認します。
- アカウント、エンティティ、デプロイメント タイプ、その他の属性で変更イベントをフィルターし、結果を絞り込みます。
- 時系列クエリを追加して、さまざまなエンティティとアカウントにわたる時系列データに対する変更イベントを視覚化します。
すべてのエンティティにわたって変更追跡 (変更追跡機能) にアクセスするには:
one.newrelic.comに移動し、次にAll Capabilities > Change Trackingに移動します。
ヒント
Change Trackingページを左側のナビゲーションに追加するには、ピン アイコンをクリックします。
すべてのエンティティのChange Trackingページには、アクセス権を持つすべてのエンティティとアカウントの変更イベントが表示されます。これらのイベントは、次の 2 つのコンポーネントで表示できます。
変更イベント テーブル:このテーブルには、アクセス可能なアカウントからの変更イベントがリストされます。表内の各イベントは時系列チャートにもマークされます。
- リストを絞り込むには、イベント属性とエンティティ タグを含むフィルター バーを使用します。
- タイムピッカーを使用するか、チャート上で選択範囲をクリックして直接ドラッグすることで、表示される時間範囲を調整します。
変更イベントの時系列チャート: NRQLクエリを実行し、変更イベントが重ねて表示されたこのチャートに結果を表示します。この視覚化により、データの傾向 (急増や急減など) とアカウント全体の特定のシステム変更との相関関係を把握できるようになります。
ヒント
グラフと表にはそれぞれ最大 1,000 件のイベントを表示できます。現在のフィルターと時間範囲によって 1,000 件を超えるイベントが生成された場合は、最新の 1,000 件のイベントのみが表示されます。より具体的なイベント セット (1,000 件未満) を表示するには、より制限の厳しいフィルターを適用するか、より短い時間範囲を選択します。
/* <table> <thead> <tr> <th></th> <th></th> </tr> </thead> <tbody> <tr> <td>変更イベント テーブル</td> <td> [変更追跡 (変更追跡機能)] ページの変更イベント テーブルには、アクセス可能なすべてのアカウントの変更が表示されます。 各イベントは時系列チャートにマークされます。フィルター バーを使用して、イベント属性とエンティティ タグでリストを絞り込みます。タイムピッカーで時間範囲を調整し、表示されるイベントの数を変更します。</td> </tr> <tr> <td>変更イベントの時系列チャート</td> <td>時系列チャートを使用すると、有効な <DNT>NRQL</DNT> クエリを実行し、変更イベントを結果にオーバーレイできます。この機能は、チャート データの急上昇とすべてのアカウントの変更イベントを相関させるのに役立ちます。</td></tr> </tbody> </table> */
変更追跡 (変更追跡機能) エンティティ スコープのビュー
エンティティ スコープのChange Trackingビューには、APM、ブラウザー、モバイルなどの特定のエンティティの変更イベントが表示されます。また、各変更イベントのゴールデンシグナルに関連する追加情報も提供します。
エンティティ スコープ ビューのChange Trackingにアクセスするには:
- one.newrelic.comに移動し、次にAll Entitiesに移動します。
- 必要なエンティティを選択し、 Change Trackingをクリックします。
NerdGraphを使用した変更追跡
New Relic Change Tracking (変更追跡機能) 機能を使用すると、システムに対するさまざまな変更の影響を監視できます。 たとえば、マーケティング キャンペーンを変更イベントとして記録し、変更追跡 (変更追跡機能) UIを使用して、グラフを通じてシステム パフォーマンスに対するその影響を分析できます。
デプロイメントやその他の種類の変更イベントを記録するには、NerdGraph ミューテーションchangeTrackingCreateEventを使用します。NerdGraph の使用に関する詳細については、 「NerdGraph の概要」を参照してください。
要件
変更追跡 (変更追跡機能) イベントの突然変異
必須属性とオプション属性を指定して変更イベントを作成するには、 changeTrackingCreateEventミューテーションを使用します。
重要
changeTrackingCreateEventミューテーションを使用して作成された変更イベントは、現在、パブリック プレビュー中は、APM サマリー デプロイメント タイルと Transaction 360 機能には表示されません。これらのイベントは、GA の両方に表示される予定です。
属性 | データ型 | 説明 |
|---|
category
| 弦 | category属性を使用すると、さまざまなcategoriesとtypesを使用して変更を分類できます。事前定義された標準のカテゴリとタイプを使用することも、独自のカスタムのものを定義することもできます。
標準のカテゴリとタイプを使用するには: カスタム カテゴリを使用するには: 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を構成する必要があります。 ヒントvalidationFlags ALLOW_CUSTOM_CATEGORY_OR_TYPEに設定されている場合、カスタムcategoryまたはtype属性に指定する文字列値が、New Relic UI に表示されることを意図したとおりの大文字と小文字を正確に使用していることを確認してください。
|
entitySearchquery
| 弦 | エンティティ検索属性を使用すると、New Relic 内で特定のエンティティを見つけることができます。特定のエンティティGUIDを使用して検索することも、 entityGuidが不明な場合は他の識別情報を指定して検索することもできます。entityGuid 、 New Relic計装またはセットアップ中にアプリケーションやマイクロサービスなどのシステム コンポーネントに割り当てる一意の識別子です。 エンティティの詳細については、 New Relicエンティティ」を参照してください。 特定のエンティティ: idやnameなどのさまざまなプロパティで完全一致またはあいまい一致を検索できますが、厳密に 1 つのエンティティに解決できるほど具体的である必要があります。 サポートされている演算子: エンティティ検索クエリでは、 = 、 AND 、 IN 、およびLIKEがサポートされている演算子です。 特殊文字の使用: ( 、 . , 、 ; 、 : 、 * 、 - 、 _ 、 )などの特殊文字は、クエリ文字列では空白文字として扱われます。たとえば、 name LIKE ':aws:'のようなクエリは、 -awsまたはfoo.awsを含むエンティティ名に一致します。 タグ: バッククォートの有無にかかわらず、タグを参照できます。 デフォルトのエンティティpropertiesおよびtagsに基づいてエンティティをフィルタリングできます。 例： - 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使用して、既存のグループに変更を追加することもできます。
ヒントNew Relic では、1 つ以上のエンティティに対して複数の更新を行う場合、またはシステム全体にさまざまな変更を実装する場合に、 groupId属性を使用することをお勧めします。 |
shortDescription
| 弦 | 各変更の簡単な説明により、New Relic に送信された変更イベントをすぐに識別できます。空白のままにすると、エンティティ、ユーザー、バージョンを含む自動生成された説明が作成されます。短い説明は次の領域に表示されます。 |
user
| 弦 | ユーザー ID または有効な電子メール アドレス。たとえば、ユーザー: datanerd@example.com
。 |
changelog
| 弦 | category
Deployment
に設定されている場合、オプションで changelog
情報を含めることができます。 |
commit
| 弦 | category
Deployment
に設定されている場合、オプションで commit SHA
などの commit
情報を含めることができます。 |
deepLink
| 弦 | category
Deployment
に設定されている場合、オプションで URL などの deepLink
を含めることができます。 |
New Relic はtimestamp属性とchangeTrackingId属性を自動的に設定します。timestamp値を変更できます。ただし、 changeTrackingId一意である必要があり、常に New Relic によって生成されます。
パラメーター | データ型 | 説明 |
|---|
タイムスタンプ | EpochMilliseconds
| timestamp属性は、NerdGraph 呼び出しが受信された時刻を示します。Unix エポックからのミリ秒数を指定して変更できます。例: timestamp: 1032480000000 。
重要NerdGraph 呼び出しが行われたとき、タイムスタンプは現在の時刻から +/- 24 時間以内に適用する必要があります。そうしないと、ペイロードは拒否されます。 |
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キーワードとの名前の競合を防ぐために、次のカスタム アトリビュート名が制限されています。
accountIdagoandappIDasautobeginbegintimecategorycategoryTypechangeTrackingIdcomparecustomAttributescustomTypedaydaysdescriptionendendtimeentity.domainentity.guidentity.nameentity.typeentityGuidentityNameexplaineventTypefacetfromfb.inputgroupIdhostnamehourhoursinislikelimitlogminuteminutesmonthmonthsnotnulloffsetorplugin.typerawsecondsecondsselectsincetimeseriestimestamptypeuntiluserweekweekswherewith
サンプル変異
次の例は、追跡マーカーを作成するための、必須属性とオプション属性を含む NerdGraph ミューテーションを示しています。
changeTrackingCreateEvent(
categoryFields: { deployment: { version: "1234" } }
kind: { category: "deployment", type: "basic" }
entitySearch: { query: "id = 'entity guid goes here'" }
changeTrackingCreateEvent(
kind: { category: "BUSINESS_EVENT", type: "CONVENTION" }
shortDescription: "sample activity event description"
description: "sample event description"
entitySearch: { query: "id = 'entity guid goes here'" }
New Relic での変更を表示および分析する方法
詳細ページには、デプロイメント タイプの変更の場合と同様に、非デプロイメントの変更に対しても同様の機能が提供されます。詳細については、 「変更の表示と分析」を参照してください。
NRQL を使用して変更イベントをクエリする
NRQLと NerdGraph を使用して変更イベントをクエリし、変更を分析および視覚化できます。使用できるクエリの例を次に示します。
目的 | NRQL/ナードグラフ | クエリ |
|---|
先週の変更イベントを取得するには | NRQL | SELECT * FROM ChangeTrackingEvent SINCE 1 week ago
|
過去 1 か月間のアプリケーションのトランザクションエラーと変更マーカーを比較する | NRQL | WHERE appName = 'INSERT_YOUR_APP_NAME' AND http.statusCode > 300 SINCE 1 month ago TIMESERIES
|
過去1時間のすべてのアカウントのイベントの一覧を表示する | NerdGraph | |
変更イベント データを timeWindow
、 accountIds
、およびエンティティ guid でフィルタリングするには query
| NerdGraph | startTime: INSERT_MS_EPOCH_TIMESTAMP endTime: INSERT_MS_EPOCH_TIMESTAMP accountIds: INSERT_ACCOUNTIDS query: "entity.guid='INSERT_ENTITYGUID'"
|
クエリと制限を使用してフィルタリングする | NerdGraph | filter: { query: "user = 'ChangeTrackingUser'", limit: 10 }
|
サポートされているカテゴリタイプ
次の値は、変更追跡 (変更追跡機能) イベントの有効なカテゴリとタイプのペアです。
カテゴリー | タイプ |
|---|
Deployment
| Basic
|
Deployment
| Blue Green
|
Deployment
| Canary
|
Deployment
| Canary
|
Deployment
| Rolling
|
Deployment
| Shadow
|
Deployment Lifecycle
| Artifact Copy
|
Deployment Lifecycle
| Artifact Deletion
|
Deployment Lifecycle
| Artifact Deployment
|
Deployment Lifecycle
| Artifact Move
|
Deployment Lifecycle
| Build Deletion
|
Deployment Lifecycle
| Build Promotion
|
Deployment Lifecycle
| Build Upload
|
Deployment Lifecycle
| Image Deletion
|
Deployment Lifecycle
| Image Promotion
|
Deployment Lifecycle
| Image Push
|
Deployment Lifecycle
| Release Bundle Creation
|
Deployment Lifecycle
| Release Bundle Deletion
|
Deployment Lifecycle
| Release Bundle Sign
|
Feature Flag
| Basic
|
Business Event
| Convention
|
Business Event
| Marketing Campaign
|
Business Event
| Other
|
Operational
| Crash
|
Operational
| Other
|
Operational
| Scheduled Maintenance Period
|
Operational
| Server Reboot
|
