このページでは、タグとは何か、タグの使用方法、および Cisco Cloud Observability でタグを使用する場所について説明します。

タグは、ホスト、ロードバランサ、ポッド、サービスインスタンスなどのエンティティデータに関連付けられたキーと値のペアで構成されるラベルです。Cisco Cloud Observability では以下が表示されます。

  • 昇格された属性/伝播されたタグ：Cisco Cloud Observability は、特定の属性をタグに自動的に昇格します。たとえば、リージョン、名前空間、クラスタなどです。これらの属性は、クラウドサービス、Kubernetes® ワークロード、および OpenTelemetry™ リソース属性から取得されます。 
  • グローバルタグ：Cisco Cloud Observability プラットフォームで事前定義されたタグ。これらは、特定のエンティティから発生するすべてのメトリック、イベント、ログ、およびトレース（MELT）データに最適化され、伝播される予約済みタグです。グローバルタグは、タグに昇格される属性のサブセットです。  
  • インポートされたタグ：クラウドコレクタからインポートされたタグと Kubernetes ワークロードからのラベル。 

タグの使用例

タグを使用すると、 監視可能なスタック全体でデータを検出し、動的に整理できます。タグを使用して次のことができます。

  • エンティティとそれに対応する MELT データをフィルタ処理およびグループ化します。
  • エンティティの正常性スコープを制限します。
  • 問題の根本原因を迅速にトラブルシューティングして分析します。

タグの形式と制限

タグの形式は key:value で、value は文字列です。次の制約事項がタグに適用されます。

  • 使用できる文字：UTF-8 で表現可能な文字、数字、スペース、および以下の文字：+ - = . _ : / @
  • インポートされたタグ：サポートされていない文字をアンダースコア（_）に置き換えます。
  • キーの最大長：512 文字
  • 値の最大長：256 文字
  • エンティティあたりのタグの最大数：100

タグキー：

  • 値の最大長さは 600 未満
  • 次の正規表現パターンに従う必要があります。"[a-zA-Z0-9+\\-=._:/@ ]*

サポートされている演算子

これらの演算子を使用して、タグを使用したデータのフィルタ処理を行えます。

演算子構文
=<tag> = <value>
!=<tag> != <value>
in<tag> in [<value1>, <value2>, ..., <valueN>]

インポートされたタグ

クラウドサービスを Cisco Cloud Observability に接続するときに、クラウドエンティティに関連付けられたタグをインポートできます。デフォルトでは、すべてのタグがインポートされます。タグをインポートすると、タグを使用して正常性ルールの範囲をフィルタ処理、グループ化、および削減できます。タグのインポートを有効にし、除外するタグを指定するには、以下を参照してください。

Kubernetes エンティティの場合、Kubernetes オブジェクトのラベルは自動的に取り込まれ、Cisco Cloud Observability でカスタムタグとして表示されます。これらのタグを使用すると、エンティティの正常性ルールの範囲をフィルタ処理、グループ化、および削減できます。特定のラベルを除外するには、Splunk AppDynamics コレクタの構成中に filter パラメータ内の labels を使用します。「AppDynamics Collectors Settings」を参照してください。 

グローバルタグ

グローバルタグは、インフラストラクチャにタグを付けるために使用できる、事前定義され、最適化された不変のタグキーです。グローバルタグは、タグに昇格される属性のサブセットです。エンティティがグローバルタグでタグ付けされると、Cisco Cloud Observability は、エンティティから生成されたメトリック、イベント、ログ、およびトレースに同じタグを自動的に伝播します。グローバルタグを使用して、さまざまなエンティティタイプ間で MELT データをフィルタ処理およびグループ化できます。たとえば、タグ region=eu-west-2 を使用して、ポッド、ホスト、およびサービスインスタンスを返すことができます。グローバルタグを使用した MELT データのフィルタリングは、現在 API でのみサポートされています。

伝播されたタグ

一部の重要な属性は、タグに昇格されます。エンティティタイプに属するこれらのタグは、エンティティ関係モデルに基づいて他のエンティティに伝播されます。たとえば、ワーカーノードの aws.region タグは、同じワーカーノードのポッドに伝播されます。 

次のセクションには、伝播されたタグのリストと、タグが伝播されるエンティティが含まれています。

Kubernetes から伝播されたタグ

これらのタグを使用して、テーブルにリストされているエンティティの情報をフィルタ処理できます。

昇格された属性タグエンティティ
  • service.namespace
  • k8s.namespace
  • k8s.namespace.name

名前空間

  • k8s.cluster.name
  • aws.ecs.cluster.name

クラスタ

k8s.workload.name

workload.name

Kubernetes エンティティを監視するには、「Kubernetes エンティティ」を参照してください。

AWS から伝播されたタグ

これらのタグを使用して、テーブルにリストされているエンティティの情報をフィルタ処理できます。

昇格された属性タグエンティティ
cloud.region

aws.region

cloud.account.id

aws.account.id

AWS エンティティを監視するには、「AWS インフラストラクチャ エンティティの観察」を参照してください。

Azure から伝播されたタグ

これらのタグを使用して、テーブルにリストされているエンティティの情報をフィルタ処理できます。

昇格された属性タグエンティティ
cloud.region

azure.location

cloud.account.id

azure.subscription.id

azure.resource.group

azure.resource_groups

Azure エンティティを監視するには、「Observe Azure Infrastructure Entities」を参照してください。

Google Cloud Platform から伝播されたタグ

これらのタグを使用して、テーブルにリストされているエンティティの情報をフィルタ処理できます。

昇格された属性タグエンティティ
cloud.account.idgcp.project.id
cloud.regiongcp.region

Google Cloud Platform エンティティを確認するには、「Observe Google Cloud Platform Infrastructure Entities」を参照してください。

タグを使用する

タグを使用してフィルタを作成し、必要なエンティティとデータのみを表示できます。

[Observe] ページ

[Observe] ページでは、エンティティ をグループ化し、グローバルタグを使用してフィルタ を作成できます。「フィルタ」を参照してください。 

[Observe] はグローバルタグのみを表示し、クラウド接続からインポートされたタグは表示しません。

Cisco Cloud Observability は、次のグローバルタグを使用します。

  • aws.region

  • azure.location
  • azure.resource_group
  • cluster
  • env
  • namespace
  • owner
  • service
  • version

エンティティ中心のページリストビュー

エンティティ中心のページリストビューでは、タグを使用してフィルタを作成できます。タグを使用してエンティティをフィルタ処理し、正常性ルール評価の範囲を制限します。「フィルタ」および「正常性ルール」を参照してください。

クラウドサービスタグ

クラウド接続を作成するときは、タグに基づいて、モニターするクラウド サービス インスタンスを制限できます。次の表に、タグ式の例を示します。

式説明例
Simple Expression= および != 演算子を使用して、キーと値の一致を実行します。
  • tags(project) = 'cloudcollectors'
  • tags(project) != 'cloudcollectors'
In ExpressionIN 演算子を使用して、指定されたキーの値のセットを含めたり除外したりします。
  • tags(jira) IN [ 'XTNXBL', 'ACE' ]
  • !(tags(region)  IN [ 'US', 'IN' ])
Has ExpressionHAS 演算子を使用して、指定されたキーの有無をチェックします。
  • HAS tags(createdBy)
  • !(HAS tags(createdBy))
Logical Expression&& および || 演算子を使用して、2 つ以上の式を結合します。
  • tags(project) = 'cloudcollectors' || tags(jira) = 'XTNXBL'
  • tags(project) = 'cloudcollectors' && tags(jira) = 'XTNXBL'
Expression Group( ) 演算子を使用して複数の式をグループ化し、評価の順序を制御します。ネストグループはサポートされていません。

(tags(project) = 'cloudcollectors' && tags(jira) = 'XTNXBL')

Complex Expression2 つ以上の式を結合します。

(tags(env) = 'prod' || tags(env) = 'production') )
&& tags(project)  = 'cloudcollectors'  
&& tags(jira) IN [ 'XTNSBL', 'ACE' ]  
&& !(tags(region) IN ['US', 'IN'] )
&& HAS tags(monitorEnabled) 
&& !(HAS tags(restrictedUse))

クラウド接続の詳細については、次を参照してください。

  1. AWS クラウド接続の構成
  2. Azure クラウド接続の設定
  3. Google Cloud Platform 接続の設定

This page has not yet been translated to Japanese.