GraphQLタグ作成APIチュートリアル

New Relic Oneは、New Relicで監視するすべてのエンティティへのアクセスを一元化します。タグを使用して、エンティティの整理やグループ化を行い、ご利用環境の理解とトラブルシューティングに活かせます。タグの追加や削除、変更は、GraphQL APIを通じて行います。GraphQL APIを使用して、キーや関連する値のリストによりエンティティにタグを付けることができます。

エンティティのクエリの詳細については、New Relic GraphQL APIを使用してエンティティのクエリを行うを参照してください。

このクエリを構成し、回答を表示するには、New Relic GraphQLエクスプローラーを使用できます。

エンティティのタグを読む

タグAPIを使用して、既存のタグとその値を読みます。entitySearch()を使用してエンティティを検索し、タグをフェッチします。この例では、エンティティはCookie Checkoutと呼ばれるブラウザアプリです。

{
  actor {
    entitySearch(query: "name like 'Cookie Checkout'") {
      results {
        entities {
          tags {
            key
            values
          }
        }
      }
    }
  }
}

実際の値は、データにより異なります。New Relic GraphQLエクスプローラーを使用して、クエリの実験を行います。

エンティティのタグを追加する

APIを使用して、エンティティの新たなタグを追加します。タグを追加するには:

  1. タグを付けるエンティティのGUIDを検索します。entitySearch()を使用してGUIDをフェッチできます。

  2. taggingAddTagsToEntityミューテーションを使用して、値のあるタグをエンティティに追加します。この例では、UIチームが所有するCookie Checkoutと呼ばれるブラウザアプリケーションがあります。値uiのついたteamタグを、このインスタンスに追加します。タグを追加したら、タグteam:uiにより絞り込みを行い、New Relic One UIでCookie Checkoutアプリを検索できます。

    mutation {
        taggingAddTagsToEntity(
            guid: "ENTITY_GUID",
            tags: { key: "team", values: ["ui"]}) {
                errors {
                    message
                }
            }
    }
    

エンティティからタグを削除する

タグと関連するすべての値を、エンティティから削除できます。

タグを削除するには:

  1. タグを削除するエンティティのGUIDを見つけます。entitySearch()を使用してGUIDをフェッチできます。

  2. taggingDeleteTagFromEntityミューテーションを使用します。次のミューテーションの例では、エンティティからチームタグを削除します。

    mutation {
        taggingDeleteTagFromEntity(
            guid: "ENTITY_GUID",
            tagKeys: ["team"]) {
                errors {
                    message
                }
            }
    }
    

エンティティの特定のタグの値を削除する

タグ全体とすべての値を削除する代わりに、単一のタグの値を削除できます。

タグの値を削除するには:

  1. タグを削除するエンティティのGUIDを見つけます。entitySearch()を使用してGUIDをフェッチできます。

  2. taggingDeleteTagValuesFromEntityミューテーションを使用します。次のミューテーションの例では、値uitagキーから削除します。

    mutation {
        taggingDeleteTagValuesFromEntity(
            guid: "ENTITY_GUID",
            tagValues: [{key: "team" value: "ui"}]) {
                errors {
                    message
                }
            }
    }
    

    tagValuesは配列なので、1つのミューテーションの単一のエンティティから複数の特定の値を削除できます。

エンティティのすべてのタグの値を置換する

タグの既存のすべての値を、新しい値で置換できます。

すべてのタグの値を置換するには:

  1. タグを削除するエンティティのGUIDを見つけます。entitySearch()を使用してGUIDをフェッチできます。

  2. taggingReplaceTagsOnEntityミューテーションを使用します。この例では、Cookie Checkoutブラウザアプリケーションがuiチームからcookie-devチームに転送されました。チームのタグの値を、次のミューテーションで置換できます。

    mutation {
        taggingReplaceTagsOnEntity(
            guid: "ENTITY_GUID",
            tags: {key: "team" values: ["cookie-dev"]}) {
                errors {
                    message
                }
            }
    }
    

その他のヘルプ

推奨する詳細情報: