Managed Service for OpenTelemetry は、OpenTelemetry、Jaeger、Zipkin、SkyWalking クライアントからのトレースデータを受け付けます。このガイドでは、サービスの有効化、認証トークンの取得、およびトレースの送信を開始するためのアプリケーションの接続方法について説明します。
前提条件
認証トークンの取得
サービスを有効化した後、アプリケーションが送信するトレースデータを認証するためのトークンを取得します。手順は、新しいコンソールと古いコンソールで異なります。
新しいコンソール
左側のナビゲーションペインで、[Integration Center] をクリックします。
[Open Source Frameworks] セクションで、[OpenTelemetry] カードまたは使用したいクライアントのカードをクリックします。
表示されたパネルで、トークンをコピーします。
表示されたパネルで、次の設定を行います。リージョン (例：中国 (杭州)) を選択します。接続方法については、Alibaba Cloud の本番環境にデプロイされたアプリケーションにはプライベートエンドポイントを選択し、その他のアプリケーションにはパブリックエンドポイントを選択します。報告方法については、[HTTP] (推奨) または [gRPC] を選択します。設定が完了したら、[Access point information] セクションでエンドポイント URL を取得します。たとえば、HTTP 経由でデータを報告する場合、プライベートエンドポイントをコピーします。エンドポイント URL にはトークンが含まれています。
古いコンソール
左側のナビゲーションペインで [Cluster Configurations] をクリックし、次に [Access point information] タブをクリックします。
ページ上部でリージョンを選択し、[Cluster Information] セクションで [Show Token] スイッチをオンにします。
[Client] セクションで、[OpenTelemetry] または使用したいクライアントを選択します。
[Related Information] カラムからエンドポイントをコピーします。
OpenTelemetry を例として、[Related Information] カラムには次のアクセスポイント情報が表示されます：
HTTP 経由でのデータ報告：パブリックエンドポイントとプライベートエンドポイントが提供されます。URL は次の形式です：
http://tracing-analysis-dc-{region}.aliyuncs.com/adapt_{token}/api/otlp/traces。gRPC 経由でのデータ報告：パブリックエンドポイント (ポート 8090)、プライベートエンドポイント (ポート 8090)、および認証トークンが提供されます。
下部のヒント：Golang を使用してデータを報告する場合、エンドポイントから
http://を削除してください。
プロトコル別のトークン使用方法
アプリケーションがトークンを渡す方法は、プロトコルによって異なります：
HTTP ベースのプロトコル (OpenTelemetry HTTP、Jaeger HTTP、Zipkin HTTP)：トークンはエンドポイント URL に埋め込まれます。
gRPC ベースのプロトコル (OpenTelemetry gRPC、Jaeger gRPC、SkyWalking gRPC) では、gRPC の
metadataにAuthentication=<token>を設定します。
アプリケーションの接続
エンドポイントの選択
各リージョンでは、2 種類のエンドポイントが提供されます：
プライベートエンドポイント：Alibaba Cloud の本番環境にデプロイされたアプリケーション用。
パブリックエンドポイント：Alibaba Cloud の外部で実行されるアプリケーション用。
サポートされるプロトコルとポート
すべてのプロトコルは同じエンドポイントドメインを共有します。ポート番号と URL パスで各プロトコルが区別されます。
| ポート | プロトコル | URL パス |
|---|---|---|
| 8090 | OpenTelemetry gRPC | N/A |
| 80 | OpenTelemetry HTTP | /api/otlp/traces |
| 80 | Jaeger HTTP | /api/traces |
| 80 | Jaeger Remote Sampling | /api/sampling |
| 80 | Zipkin HTTP v1 | /api/v1/spans |
| 80 | Zipkin HTTP v2 | /api/v2/spans |
| 443 | OpenTelemetry HTTPS | /api/otlp/traces |
| 443 | Jaeger HTTPS | /api/traces |
| 443 | Jaeger Remote Sampling (HTTPS) | /api/sampling |
| 443 | Zipkin HTTPS v1 | /api/v1/spans |
| 443 | Zipkin HTTPS v2 | /api/v2/spans |
| 1883 | Jaeger gRPC | N/A |
| 1883 | SkyWalking gRPC | N/A |
| 8000 | SkyWalking v8 gRPC | N/A |
リージョンとエンドポイント
Alibaba Cloud の本番環境にデプロイされたアプリケーションには、プライベートエンドポイントを使用してください。それ以外の場合は、パブリックエンドポイントを使用してください。
| リージョン | リージョン ID | プライベートエンドポイント | パブリックエンドポイント |
|---|---|---|---|
| 中国 (杭州) | cn-hangzhou | tracing-analysis-dc-hz-internal.aliyuncs.com | tracing-analysis-dc-hz.aliyuncs.com |
| 中国 (上海) | cn-shanghai | tracing-analysis-dc-sh-internal.aliyuncs.com | tracing-analysis-dc-sh.aliyuncs.com |
| 中国 (青島) | cn-qingdao | tracing-analysis-dc-qd-internal.aliyuncs.com | tracing-analysis-dc-qd.aliyuncs.com |
| 中国 (北京) | cn-beijing | tracing-analysis-dc-bj-internal.aliyuncs.com | tracing-analysis-dc-bj.aliyuncs.com |
| 中国 (張家口) | cn-zhangjiakou | tracing-analysis-dc-zb-internal.aliyuncs.com | tracing-analysis-dc-zb.aliyuncs.com |
| 中国 (フフホト) | cn-huhehaote | tracing-cn-huhehaote-internal.arms.aliyuncs.com | tracing-cn-huhehaote.arms.aliyuncs.com |
| 中国 (ウランチャブ) | cn-wulanchabu | tracing-cn-wulanchabu-internal.arms.aliyuncs.com | tracing-cn-wulanchabu.arms.aliyuncs.com |
| 中国 (深圳) | cn-shenzhen | tracing-analysis-dc-sz-internal.aliyuncs.com | tracing-analysis-dc-sz.aliyuncs.com |
| 中国 (河源) | cn-heyuan | tracing-cn-heyuan-internal.arms.aliyuncs.com | tracing-cn-heyuan.arms.aliyuncs.com |
| 中国 (広州) | cn-guangzhou | tracing-cn-guangzhou-internal.arms.aliyuncs.com | tracing-cn-guangzhou.arms.aliyuncs.com |
| 中国 (成都) | cn-chengdu | tracing-cn-chengdu-internal.arms.aliyuncs.com | tracing-cn-chengdu.arms.aliyuncs.com |
| 中国 (香港) | cn-hongkong | tracing-analysis-dc-hk-internal.aliyuncs.com | tracing-analysis-dc-hk.aliyuncs.com |
| 日本 (東京) | ap-northeast-1 | tracing-analysis-dc-jp-internal.aliyuncs.com | tracing-analysis-dc-jp.aliyuncs.com |
| シンガポール | ap-southeast-1 | tracing-analysis-dc-sg-internal.aliyuncs.com | tracing-analysis-dc-sg.aliyuncs.com |
| マレーシア (クアラルンプール) | ap-southeast-3 | tracing-ap-southeast-3-internal.arms.aliyuncs.com | tracing-ap-southeast-3.arms.aliyuncs.com |
| インドネシア (ジャカルタ) | ap-southeast-5 | tracing-analysis-dc-indonesia-internal.aliyuncs.com | tracing-analysis-dc-indonesia.aliyuncs.com |
| ドイツ (フランクフルト) | eu-central-1 | tracing-analysis-dc-frankfurt-internal.aliyuncs.com | tracing-analysis-dc-frankfurt.aliyuncs.com |
| イギリス (ロンドン) | eu-west-1 | tracing-analysis-dc-lundun-internal.aliyuncs.com | tracing-analysis-dc-lundun.aliyuncs.com |
| 米国 (シリコンバレー) | us-west-1 | tracing-analysis-dc-usw-internal.aliyuncs.com | tracing-analysis-dc-usw.aliyuncs.com |
| 米国 (バージニア) | us-east-1 | tracing-us-east-1-internal.arms.aliyuncs.com | tracing-us-east-1.arms.aliyuncs.com |
| サウジアラビア (リヤド - パートナーリージョン) | me-central-1 | tracing-me-central-1-internal.arms.aliyuncs.com | tracing-me-central-1.arms.aliyuncs.com |
Alibaba Cloud 以外のアプリケーションのネットワーク要件
アプリケーションが Alibaba Cloud の外部で実行されている場合は、トレースデータを送信する前に、お使いのネットワークから次のポートとドメインに到達可能であることを確認してください。
許可が必要なポート：
| ポート | プロトコル |
|---|---|
| 8090 | OpenTelemetry gRPC |
| 80 | OpenTelemetry HTTP、Jaeger HTTP、Jaeger Remote Sampling、Zipkin HTTP v1、Zipkin HTTP v2 |
| 443 | OpenTelemetry HTTPS、Jaeger HTTPS、Jaeger Remote Sampling (HTTPS)、Zipkin HTTPS v1、Zipkin HTTPS v2 |
| 1883 | Jaeger gRPC、SkyWalking gRPC |
| 8000 | SkyWalking v8 gRPC |
許可が必要なドメイン：上記の リージョンとエンドポイント の表から、お使いのリージョンのパブリックエンドポイントドメインを使用してください。