• /
  • ログイン
  • 無料アカウント

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

ソフトウェア業界では、タグは通常、データの編成とファインダビリティを強化する目的でデータセットに追加されたメタデータを指します。

New Relicのタグは、モニターするアプリとホスト、エージェント、ダッシュボード、およびワークロードなど、様々なデータセットに追加された「キー:値」のペアです(team: operationsなど)。いくつかの重要な属性はタグとして利用可能です(アプリ名と言語などのアプリのメタデータ、およびホスト名とAWSリージョンなどのホストのメタデータなど)。また、ユーザー独自のタグを追加することもできます。

以下に示すように、UIでタグを使用して関連データを絞り込むことができます。

タグを使用したNew Relicフィルタリングワークロード

ここでは、accountIdタグを使って、特定のアカウントのワークロードをフィルターしています。

タグを使用して次のことができます。

  • 大量のソースおよび大量のNew Relicアカウントからのデータを整理する
  • チーム、ロール、環境、またはリージョンを特定して、誰が何に対して責任があるかを把握する(使用事例を参照)
  • ダッシュボードとワークロードの編成と検索を改善する

タグは、高レベルでデータを整理するのに役立ちます。ユーザー名やその他の高カーディナリティの値の取得など、よりきめ細かい詳細を追加する場合、カスタムアトリビュートカスタムイベントがより適切な解決策になります。

ヒント

以前、New Relicでは、タグは「ラベル」と呼ばれていました。コード内で「label」が使用されている場合があります。例えば、当社の一部のAPMエージェント設定ファイルは、タグに対してlabel設定オプションを使用します。

読み進めて、タグの詳細を学んでください。

タグの形式と制限

タグの形式要件と制限:

  • UIでは、1エンティティ当たりに表示できるタグ総数の上限があります。
    • デフォルトでレポートされるタグ、またはエージェント/インテグレーション設定を通して追加されるタグの最大数は100です。
    • UIまたはAPIを通して追加されるカスタムタグの最大数は100です。
  • タグの最大文字長を以下に示します。
    • キー:128文字
    • 値:256文字
  • APIを使用してタグを追加する場合、タグキー内のハイフン(-)は、マイナス記号として解釈されます。タグキーにハイフンが含まれる場合、その両側にバッククォートを付けます(例:`key-name`)。

ベストプラクティスとヒント

タグを追加する前に、当社のデフォルトタグのしくみを理解することをお勧めします。独自のタグを追加する準備ができたら、以下のベストプラクティスを活用してください。

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

  • 最初は、確実に使用することが分かっているタグのみを追加します。未使用のタグによってノイズが生じ、混乱が生まれる可能性があります。
  • 短いタグを使用するように努めます。短いタグは解析が簡単です。また、UIでは長いタグが切り詰められる場合もあります。(「文字制限」を参照してください。)
  • 可能な場合は、人間が読めるキーと値を使用します(例えば、region: EMEAParam8323 : 1229072よりも推奨されます)。
  • regions: EMEA | US | LATAMなどの複数の値を単一のタグに含めることは避けてください。このような場合は、region: emearegion: us、およびregion: latamなどの、3種類のタグを使用することをお勧めします。複数のタグを一致させる場合は、フィルターUIで高度なオプションを使用して行うことができます。

一貫性のあるタグの使用に関するヒント

  • チームとエンティティにわたり、タグ言語に一貫性を持たせるよう努めます。
  • 命名に一貫性を持たせます。例えば、region: emeareg: emeaの両方を使用するのは避けます。
  • 形式に一貫性を持たせます。例えば、キャメルケース(camelCase)とケバブケース(kebab-case)の両方を使用するのは避けます。
  • 大文字の使用に一貫性を持たせます。例えば、env: stagingenv: Stagingの両方を使用するのは避けます(ただし、UIとAPIでのタグ検索では大文字と小文字が区別されます)

クロスチームの実装に関するヒント:

  • タグを使用する理由の1つは、オブザーバビリティとコスト配分を改善することです。この理由から、多くの場合、タグ実装の責任はオブザーバビリティチーム、SRE、アーキテクトのグループ、またはクロスチームタスクフォースに割り当てられます。
  • タグの実装に責任を持つ人々が内部ポリシーを順守し、内部ポリシーを作成して、タグの定義方法と使用する規則を説明することをお勧めします。このリファレンスマニュアルを常に最新の状態にしてください。
  • New Relicエージェントをデプロイする時に、タグの定義を自動化します。この自動化は、クラウドプロバイダーで行うか、APIやTerraformなどのNew Relic自動化ツールを通して行うことができます。
  • タグ付け基準に準拠していないエンティティを識別する定期レポートを作成します。

タグの例

タグを使用してデータを整理するための一般的な方法の例を以下に示します。

タグの追加方法

デフォルトで、一部の重要な属性をタグとして使用できます。例えば、アカウント名、アカウントID、およびいくつかの基本的なホスト/サーバーのメタデータはデフォルトのタグとして利用可能です。これらのデフォルトで利用可能なタグは削除できません。

特定のデータソースに対するタグの追加方法の詳細を以下に示します。

タグを使用してUIをフィルターする

New Relicの高度なタグフィルタークエリ

エンティティ エクスプローラーの上部にあるフィルターフィールドを使用して、目的のエンティティを絞り込みます。複数のフィルター条件を使用できます。

タグを使用して特定のエンティティを絞り込むには:

  1. one.newrelic.comEntity explorerをクリックします。
  2. Filtering...フィールドをクリックすると、利用可能な属性とタグのドロップダウンが表示されます。
  3. 複数の要素でフィルターしたり、詳細検索オプションを使用したりすることができます。

UIからエンティティのメタデータとタグを検索する場合、2つのオプションがあります。

  • 一番右にあるUI内のエンティティリストから、エンティティの アイコンをクリックします。

    または

  • エンティティを選択します。ページ上部の近くにある アイコンを選択します。

APIを使用してタグを表示する方法は、当社のNerdGraphドキュメントをご覧ください。

タグを使用してダッシュボードを整理する方法およびワークロードでのタグの使用方法をご確認ください。

カスタムクエリおよびチャート

タグソースで説明されているように、一部の属性はタグとして利用可能です。NRQLを使用して、属性をクエリしたり、カスタムチャートを作成したりできます。

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:

問題を作成するこのページを編集する
Copyright © 2020 New Relic Inc.