サービスオブザーバビリティ テンプレート変数

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：2分

    • サービスオブザーバビリティダッシュボードとチャートを編集するときにクエリで使用できるテンプレート変数を理解します。

    クエリでは、次のテンプレート変数を使用できます。変数を使用すると、複数のサービス、ホスト、データベースインスタンスに対して、またダッシュボードに対して現在選択されている期間に対してクエリを使用できます。
    注:
    Amazon CloudWatch はわずかに異なるテンプレート変数を使用します。詳細については、「AWS および Azure の高度なクエリサポート」を参照してください。
    表 : 1. テンプレート変数
    変数 説明
    {$ENTITIES_HOST} 選択したホストのメトリクスを返します
    {$ENTITIES_MYSQL} 選択した MySQL インスタンスのメトリクスを返します
    {$ENTITIES_POSTGRESQL} 選択した PostgreSQL インスタンスのメトリクスを返します
    {$ENTITIES_サービス} 選択したサービスのメトリクスを返します。
    {$ENTITIES} 選択したエンティティのメトリクスを返します。サービス、ホスト、またはデータベースのいずれか。
    {$START_TIME} 選択した開始時間を使用してメトリクス時系列を返します。
    {$END_TIME} 選択した終了時間を使用してメトリクス時系列を返します。

    サンプルクエリ

    NewRelic を使用していて、キー サービスを 値 checkout-service にマッピングするデータマッピングを作成するとします。

    クエリ builder を使用してビルドされた単純なクエリは、次のようになります。
    rate(count(apm.service.transaction.duration), 1 minute
    チェックアウトサービスサービスのトランザクションのレートを返します。
    代わりに、次のような完全なベンダークエリを使用できます。
    SELECT rate(count(apm.service.transaction.duration), 1 minute) as 'Web throughput' FROM Metric WHERE (entity.guid = 'NDc2NDMyNXxBUE18QVBQTElDQVRJT058MTA3NjIyODQwMw') AND (transactionType = 'Web') LIMIT MAX SINCE 30 minutes ago TIMESERIES UNTIL now
    これは、ハードコードされた NDc2NDMyNXxBUE18QVBQTElDQVRJT058MTA3NjIyODQwMw エンティティの過去 30 分間の期間を返します。
    任意の期間における選択したサービスの時系列を返すクエリを作成するには、エンティティと時間をテンプレート変数に置き換えます。
    SELECT average(convert(apm.service.transaction.duration, unit, 'ms')) as metricValue, average(convert(apm.service.transaction.duration, unit, 'ms')) - 100 as loop FROM Metric WHERE entity.guid IN (${ENTITIES}) FACET entity.guid, entity.name SINCE ${START} UNTIL ${END} TIMESERIES LIMIT 25