• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

この機械翻訳は参考用に提供されます。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、 を参照してください。

問題を作成する

カスタムユーザーエージェントの設定

New Relic が API インテグレーションのパブリッシャーを正しく識別するために、各インテグレーションには固有のカスタムユーザーエージェント文字列が必要です。

統合機能を社内でのみ使用し、社外の誰とも共有する予定がない場合は、独自のカスタムエージェント文字列を設定する必要はありません。

前提条件

このドキュメントでは、New Relic の公開 RESTful API を利用した統合を一般に配布することを想定しています。一般配布の例としては、以下のようなものがあります。

ユーザーエージェント

New Relic の RESTful API と連携するアプリケーションを作成する場合 (本文書では インテグレーション とします)、アプリケーションと New Relic の間の情報交換を管理するための HTTP エージェントを作成します。統合は、標準的な識別文字列を送信することで自分自身を識別します。HTTP では、この文字列は User-Agent というヘッダーフィールドに含まれます。

New Relic の RESTful API を使用する際には、API 呼び出しで統合を識別する User-Agent ヘッダーを設定します。このカスタム User-Agent 文字列により、New Relic は New Relic の API へのリクエストを行っているインテグレーションを識別することができます。

カスタムユーザーエージェントを設定することで、New Relicはトラッキングを行うことができます。

  • あなたのインテグレーションの使用統計。
  • 潜在的にバグのある、または乱用されたAPIの使用。

ユーザーエージェントの設定

カスタムユーザーエージェントを設定するには、HTTPヘッダー User-Agent にエージェント文字列を含めます。

例:

言語

cURL

curl -H 'User-Agent: my-integration/1.2.3'

Java
(GETを使用)

get.setHeader("User-Agent", "my-integration/1.2.3");

PHP

header('User-Agent: my-integration/1.2.3');

最小のユーザー エージェント文字列は、統合名とバージョン: name/versionです。複数の値をスペースで区切ったリストにまとめることができます。完全な構文は次のとおりです。

name/version [(comments)] [name/version [(comments)]] [...]​

統合名には、統合を明確かつ意味のある形で示す文字列を使用してください。

  • 曖昧な名称:New Relic Integration

  • 明確で意味のある名前:SaaS XYZTools Integration with New Relic

統合バージョンには、ビルドIDやコミットハッシュなど、新しい統合バージョンをリリースしたときに更新される識別子を使用します。

コメントはセミコロン区切りのリストとしてかっこ()で囲みます。

参考になるコメントを掲載します。

  • 統合機能の一般にアクセス可能なURL。例えば、GithubのURLや、統合について説明しているドキュメントサイトのページなどです。
  • New Relic がインテグレーションパブリッシャーに簡単に連絡できるように、連絡先情報を入力してください。

ヒント

ユーザーエージェントの文字列から得られる情報は、New Relic で共有されることはなく、出版社との統合について議論する以外の目的で使用されることもありません。

ユーザーエージェント文字列とNew Relic

New Relicでは、APIコールからユーザーエージェント文字列を取得し、ソースを特定しています。

一般に公開されている統合にカスタムユーザーエージェント文字列を使用することは、推奨されるベストプラクティスです。お客様と New Relic とのビジネス関係によっては、必須となる場合もあります。カスタムユーザーエージェント文字列で統合をラベル付けしても、New Relic の API との連携には影響しません。

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.