タグは、Datadog テレメトリーにディメンションを追加する方法のひとつで、Datadog の可視化機能によって絞り込み、集計、比較できます。タグを使用すると、多数のホストの集計パフォーマンスを観察でき、必要に応じて、特定の要素に基づいて設定をさらに絞り込むこともできます。つまり、タグ付けは集計データポイントを観察する手段です。
タグ付けにより、Datadog のさまざまなデータ タイプをバインドし、メトリクス、トレース、ログの間でアクションを関連付け、呼び出すことができます。この操作は、専用タグ キーで実行できます。以下に例を示します。
| タグ キー | 可能な操作 |
|---|---|
host | メトリクス、トレース、プロセス、ログの間の関連付け |
device | デバイスまたはディスクごとのメトリクス、トレース、プロセス、ログの分離 |
source | ログ管理のためのスパンの絞り込みと自動パイプライン |
service | メトリクス、トレース、ログにおけるアプリケーション固有データのスコーピング |
env | メトリクス、トレース、ログにおけるアプリケーション固有データのスコーピング |
version | メトリクス、トレース、ログにおけるアプリケーション固有データのスコーピング |
これは通常、集計の サービス レベルでコンテナー、VM、クラウドインフラストラクチャーに注目する際に役立ちます。たとえば、サーバー A とサーバー B で個別に CPU 使用率を確認するよりも、サービスを表すホストのコレクション全体で CPU 使用率を見る方が便利です。
コンテナとクラウド環境は常にホストの間を移動しているので、取得するメトリクスを集計できるようにタグ付けすることが重要です。
以下は、Datadog のタグ付け要件です。
タグの先頭は文字にする必要があり、その後は以下の文字を使用できます。
その他の特殊文字は、アンダースコアに変換されます。
注: tag: のようにタグの末尾にコロンを使用することはできません。
タグの長さは最大 200 文字で、Unicode (日本語などの言語を含むほとんどの文字セットを含む) をサポートします。
タグは小文字に変換されます。そのため、CamelCase (キャメル ケース) 形式のタグは推奨されません。認証 (クローラー) ベースのインテグレーションでは、タグのキャメル ケース部分はアンダースコアに変換されます。たとえば、TestTag は test_tag となります。注: host タグと device タグはこの変換から除外されます。
タグは value または <KEY>:<VALUE> の形式にすることができます。機能を最大限に活用するために、タグを** <KEY>:<VALUE> 形式に構成することをお勧めします** 。よく使用されるタグ キーは、env、instance、name です。キーの後ろには常に、グローバルタグ定義の最初のコロンが付きます。例:
| タグ | キー | 値 |
|---|---|---|
env:staging:east | env | staging:east |
env_staging:east | env_staging | east |
タグは、EPOCH タイムスタンプ、ユーザー ID、リクエスト ID などのバインドされていないソースをベースにすることはできません。実行すると、組織のメトリクス数が無限に増加し、請求に問題が発生します。
制限 (ダウンケースなど) はメトリクスタグにのみ適用され、ログ属性やスパンタグには適用されません。
タグ付けは、次のいずれか (またはすべて) の方法を使用して実行できます。タグの割り当てについては別途ドキュメントをご用意しておりますので、詳細はそちらをご参照ください。
| メソッド | タグ付けの方法 |
|---|---|
| 構成ファイル | メインの Agent またはインテグレーションのコンフィギュレーションファイルで手動で行います。 |
| UI | Datadog アプリ |
| API | Datadog の API を使用するとき |
| DogStatsD | DogStatsD 経由でメトリクスを送信するときに行います |
Datadog では、タグを付ける際のベストプラクティスとして、統合サービスタグ付けを使用することをおすすめしています。統合サービスタグ付けは、env、service、version の 3 つの標準タグを使用して Datadog テレメトリーと結合します。ご使用環境で統合タグ付けを構成する方法に関する詳細は、統合サービスタグ付けドキュメントをご参照ください。
ホストとインテグレーション レベルでタグを割り当てた後、メトリクス、トレース、ログを絞り込みグループ化するためにタグの使用を開始します。タグは、Datadog プラットフォームの次の領域で使用されます。詳細は、タグの使用方法に関するドキュメントをご参照ください。
| 領域 | タグを使用して実行すること |
|---|---|
| イベント | イベントストリームの絞り込み |
| ダッシュボード | グラフでのメトリクスの絞り込みおよびグループ化 |
| インフラストラクチャー | ホストマップ、インフラストラクチャー リスト、ライブ コンテナ、ライブプロセス ビューの絞り込みとグループ化 |
| モニター | モニターの管理、モニターの作成、ダウンタイムの管理 |
| メトリクス | Metric Explorer での絞り込みとグループ化 |
| インテグレーション | AWS、Google Cloud、Azure のメトリクスをオプションで制限 |
| APM | Analytics の絞り込み、サービス マップでの他の領域へのジャンプ |
| ノートブック | グラフでのメトリクスの絞り込みおよびグループ化 |
| ログ | ログ検索、分析、パターン、Live Tail、パイプラインの絞り込み |
| SLO | SLO、グループ化されたメトリクスベース SLO、グループ化されたモニターベース SLO の検索 |
| 開発者 | API を使用して情報を取得、または UI のさまざまな領域をセットアップ |
| 課金 | 3 つのタグを選択することで Datadog の使用量を報告します。たとえば、env、team、account_id のように選択できます。 |
お役に立つドキュメント、リンクや記事:
