Managed Service for OpenTelemetry は、OpenTelemetry、Jaeger、Zipkin、および SkyWalking のクライアントからのトレースデータを受け入れます。このガイドでは、サービスを有効化し、認証トークンを取得し、アプリケーションを接続してトレースの送信を開始するまでの手順を説明します。
前提条件
認証トークンの取得
サービスを有効化した後、アプリケーションが送信するトレースデータを認証するためのトークンを取得します。手順は、新しいコンソールと古いコンソールで異なります。
新しいコンソール
左側のナビゲーションウィンドウで、[Integration Center] をクリックします。
[Open Source Frameworks] セクションで、[OpenTelemetry] カードまたは使用したいクライアントのカードをクリックします。
表示されたパネルで、トークンをコピーします。
古いコンソール
左側のナビゲーションウィンドウで [Cluster Configurations] をクリックし、次に [Access point information] タブをクリックします。
ページの上部でリージョンを選択し、[Cluster Information] セクションの [Show Token] スイッチをオンにします。
[Client] セクションで、[OpenTelemetry] または使用したいクライアントを選択します。
[Related Information] 列からエンドポイントをコピーします。
プロトコル別のトークンの使用
アプリケーションがトークンを渡す方法は、プロトコルによって異なります：
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 リモートサンプリング | /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 リモートサンプリング (HTTPS) | /api/sampling |
| 443 | Zipkin HTTPS v1 | /api/v1/spans |
| 443 | Zipkin HTTPS v2 | /api/v2/spans |
| 14250 | Jaeger gRPC | N/A |
| 11800 | 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 外部で実行されている場合は、トレースデータを送信する前に、お使いのネットワークから次のポートとドメインが到達可能であることを確認してください。
許可が必要なポート：
| ポート | プロトコル |
|---|---|
| 80 | OpenTelemetry HTTP、Jaeger HTTP、Jaeger リモートサンプリング、Zipkin HTTP v1、Zipkin HTTP v2 |
| 443 | OpenTelemetry HTTPS、Jaeger HTTPS、Jaeger リモートサンプリング (HTTPS)、Zipkin HTTPS v1、Zipkin HTTPS v2 |
| 8000 | SkyWalking v8 gRPC |
| 8090 | OpenTelemetry gRPC |
| 11800 | SkyWalking gRPC |
| 14250 | Jaeger gRPC |
許可が必要なドメイン：上記の リージョンとエンドポイント の表から、お使いのリージョンのパブリックエンドポイントドメインを使用してください。