タグを使用すると、データの整理と検索に役立ちます

New Relicは、アカウント情報を含むエンティティに特定のタグを自動適用します。これらのタグには以下のようなものがあります。

• account
• accountId

New Relicエージェントを設定して、データから作成されたエンティティにタグを適用することができます。設定オプションはエージェントに固有ですが、通常はlabelsキーを使用します。いくつかの例：

• Javaエージェントのタグ設定

• .NETエージェントのタグ設定

  エージェント設定から適用されるタグにより、特定のエンティティ上の特定のタグキーで複数の値が生じる場合があります。これは、エージェントのデプロイされた各インスタンスが異なる値を送信するように設定できるためです。

New Relicエージェントは、環境に応じてサービスエンティティに特定のタグを自動的に適用します。以下が含まれます（ただし、これらに限定されません）。

• サービス/アプリケーションのエンティティの場合

  • language: 値は、java、pythonなどです。

• ホストエンティティの場合

  • awsRegion該当する場合

特定のOpenTelemetryリソース属性は、エンティティタグとして自動適用されます。サービスエンティティに関連付けられたスパンデータで、次の属性が存在する場合、それらの属性はそのエンティティに添付されます。

• k8s.cluster.name

• k8s.deployment.name

• k8s.namespace.name

• telemetry.sdk.language：という名前のタグとして保存されます language

• telemetry.sdk.version

• service.namespace

  この自動タグ付けは、GitHubで文書化されているNew Relicエンティティ合成を使用して実行されます。OpenTelemetryサービスの場合、タグ付けの定義はext-serviceエンティティ上に存在します。

1. 条件に移動します。

2. フォームの上部にある条件の名前の近くで、タグの管理をクリックします。

3. ポップアップ表示されるメニューで、タグを追加または削除します。

   また、NerdGraph APIを介してエンティティとしてアラート条件にタグを追加することもできます（「manage tags」画面から条件のエンティティGUIDを使用）。

   NerdGraph API経由でのデータのタグ付けの詳細については、チュートリアルを参照してください。

CLIツールを使用したタグの自動化については、当社の開発者サイトを参照してください。

• UIでは、1エンティティ当たりに表示できるタグ総数の上限があります。

  • デフォルトでレポートされるタグ、またはエージェント/インテグレーション設定を通して追加されるタグの最大数は100です。
  • UIまたはAPIを通して追加されるカスタムタグの最大数は100です。

• タグの最大文字長を以下に示します。

  • キー：128文字
  • 値：256文字

• 使用できる文字：

  • 文字はUTF-8を使用してください。
  • NerdGraphを使用してタグを追加する場合、タグキー内のハイフン-はマイナス記号として解釈されます。タグキーにハイフンが含まれる場合、その両側にバッククォートを付けます（例：`key-name`）。

タグをシンプルに保つためのヒント：

• 最初は、確実に使用することが分かっているタグのみを追加します。未使用のタグによってノイズが生じ、混乱が生まれる可能性があります。

• 短いタグを使用するように努めます。短いタグは解析が簡単です。また、UIでは長いタグが切り詰められる場合もあります。（「文字制限」を参照してください。)

• 可能な場合は、人間が読めるキーと値を使用します（たとえば、region: EMEAがParam8323 : 1229072よりも推奨されます）。

• regions: EMEA | US | LATAMなどの複数の値を単一のタグに含めることは避けてください。このような場合は、region: emea、region: us、およびregion: latamなどの、3種類のタグを使用することをお勧めします。複数のタグを一致させる場合は、フィルターUIで高度なオプションを使用して行うことができます。

  • アラートインシデントに関する注意事項：これらは1つのキー名インスタンスのみをサポートします。複数のキー名を使用する場合は、1つがランダムに選択されてそのインシデントに追加されます。

• チームとエンティティにわたり、タグ言語に一貫性を持たせるよう努めます。
• 命名に一貫性を持たせます。たとえば、region: emeaとreg: emeaの両方を使用しないでください。
• 形式に一貫性を持たせます。たとえば、camelCaseとkebab-caseの両方を使用しないでください。
• UIおよびAPIのタグ検索では大文字と小文字は区別されませんが、大文字、小文字を区別するようにします。たとえば、env: stagingとenv: Stagingの両方を使用しないでください。

タグは、オブザーバビリティとコスト配分の向上に役立ちます。この理由から、多くの場合、タグ実装の責任はオブザーバビリティチーム、SRE、アーキテクトのグループ、またはクロスチームタスクフォースに割り当てられます。

タグの実装に責任を持つ人々が内部ポリシーを順守し、内部ポリシーを作成して、タグの定義方法と使用する規則を説明することをお勧めします。次に：

• このリファレンスマニュアルを常に最新の状態にしてください。
• New Relicエージェントをデプロイする時に、タグの定義を自動化します。この自動化は、クラウドプロバイダーで行うか、APIやTerraformなどのNew Relic自動化ツールを通して行うことができます。
• タグ付け基準に準拠していないエンティティを識別する定期レポートを作成します。

チーム名のタグを作成すると、パフォーマンスの問題につながった変更に関与したチーム、グループ、部門、または地域を把握するのに役立ちます。

### Team tags
team: backend
team: frontend
team: db
### Role tags
roles: architecture
roles: devops
roles: pm
### Region tags
region: emea
region: america
region: asia

属する環境に対してエンティティを作成することができます。例:

env: production
env: qa
env: development
env: staging

重要度レベルに関連するタグを作成できます。これによって、最重要問題を簡単に追跡できるようになります。例:

layer: level1
layer: level2
layer: level3

9つのシャードに分散されたサービスがあり、各シャードがenvironmentとして割り当てられている場合、次のようなワイルドカードクエリを使用して、すべてのシャードのトランザクションスループットをプロットできます。

SELECT rate(count(apm.service.transaction.duration), 1 minute)
  FROM Metric WHERE appName LIKE 'MyApp (%' AND transactionType = 'Other'
  FACET tags.Environment TIMESERIES

特定のチームのサービスごとのトランザクション数を表示するには、次のようなクエリを使用できます。

FROM Transaction SELECT count(*)
  WHERE tags.Team = 'team-a'
  FACET tags.Project TIMESERIES

各サービスに対してルールを作成することなく、アラートを設定するためにサービスのエラー率のクエリを使用できます。これは、team-bと呼ばれるチームのすべてのサービスのエラー率です。また、このアラートは、チームタグとともに追加された新しいアプリ名をすべて自動的にモニターします。

FROM Metric SELECT count(apm.service.error.count) / count(apm.service.transaction.duration)
  WHERE tags.Team = 'team-b' FACET appName

これに関しては、複数の環境にわたってデプロイされた特定のサービスに関する一般的なルールを作成することで、各環境を個別に監視する単一サービスのアラームを作成できます。

From Metric SELECT count(apm.service.error.count) / count(apm.service.transaction.duration)
  WHERE tags.Project = 'MyProject' FACET tags.Environment

SensitiveEntityなどの名前のエンティティを所有する内部チームを検索するには、以下を実行します。

FROM SystemSample SELECT internalOwningTeam WHERE entityName = 'SensitiveEntity'

CPUを使用してさまざまなInfrastructureエンティティで、負荷テストを実行するとします。Aというグループのエンティティに1つの処理を適用し、Bというグループのエンティティに別の処理を適用し、control groupという処理を行わないエンティティの1つのグループを保持できます。

New Relic UIでexperimentGroupというタグを作成し、各エンティティが属する実験グループにマッピングできます。これらはNew Relic UIで作成されたタグであるため、newrelic-infra.yml設定ファイルで作成されたカスタム属性とは異なり、タグ名にtags.プレフィックスを追加する必要があります。

以下はcpuPercentを選択するNRQLクエリで、FACET CASES (...)句を使用してさまざまな実験グループに分類されています。

FROM SystemSample SELECT cpuPercent FACET CASES (WHERE tags.experimentGroup = 'control' AS 'control group', WHERE tags.experimentGroup = 'A' AS 'given treatment A', WHERE tags.experimentGroup = 'B' AS 'given treatment B') SINCE 1 DAY AGO

Infrastructureタグのタグ伝播をオフにするには、NerdGraphで以下を実行します。

mutation {
  dataManagementUpdateFeatureSettings(
    accountId: YOUR_ACCOUNT_ID
    setting: {
      enabled: false
      featureSetting: { key: "infra_tag_propagation" }
      locked: false
    }
  ) {
    enabled
    key
    locked
    name
  }
}

その呼び出しは、次の回答を返す必要があります。

{
  "data": {
    "dataManagementUpdateFeatureSettings": {
      "enabled": false,
      "key": "infra_tag_propagation",
      "locked": false,
      "name": "Infra tag propagation"
    }
  }
}