Instana のはじめ方 REST API

Instana ( REST API )を使用すると、 Instana の監視および可観測性プラットフォームをアプリケーションに統合することができます。

前提条件

始める前に、RESTful APIと HTTP プロトコルに関する基本的な知識があり、 Instana アカウントを所有していることを確認してください。

認証用の API トークンの生成

Instana ( REST API )へのリクエストを認証するには、 API トークンが必要です。 API トークンを生成するには、以下の手順に従ってください:

  1. Instana アカウントにログインしてください。
  2. Instana のUIにあるナビゲーションメニューから、 「設定」 をクリックします。
  3. [ セキュリティとアクセス ] タブの [ アクセス制御 ] セクションで、 [ API トークン ] をクリックします。
  4. トークンの名前を入力し、適切な権限を設定してください。
  5. API トークンが生成されたら、 API トークンをコピーし、将来の使用に備えて安全に保管してください。

要求の実行

Instana REST API 標準の HTTP メソッドを使用します。 Instana ( REST API )のベース URL は、各 Instana インスタンスに固有のものであり、テナントとユニットで構成されています。 基本の URL は、 Instana のユーザーインターフェースにアクセスするために使用される URL と同じものです。

各リクエストの認証には、 API トークンを使用してください。

  • 基本 URL: https://<TENANT>-<UNIT>.instana.io/api
  • 認証: API トークンを、プレフィックス apiToken を使用してヘッダー Authorization に含めてください。

以下の形式例は、Authorizationヘッダーに API トークンを含めた、 curl を使用したリクエストを示しています。

curl -X GET https://<TENANT>-<UNIT>.instana.io/api/<INSTANA_REST_API_ENDPOINT> \
  -H "Authorization: apiToken <YOUR_API_TOKEN>"
 

API エンドポイント

API Instana のエンドポイント REST API は、 API がさまざまな機能や操作を行うために使用する、さまざまなルートやパスを指します。 これらのエンドポイントを使用すると、データ管理の監視、アラート、カスタムイベントなど、 Instana プラットフォームのさまざまな機能を利用できます。 Instana REST API の使用方法や、各エンドポイントのリクエストパラメータ、レスポンス形式、リクエスト例などに関する詳細については、 API のドキュメントを参照してください。

速度制限

Instana ( REST API )のレート制限については、常に確認する必要があります。 これらの制限は、すべてのユーザーに対するサービスの可用性とパフォーマンスを維持するのに役立ちます。