このドキュメントでは、Telemetry（OTLP）API のロギング エンドポイント
telemetry.googleapis.comに OTLP ログを直接送信する方法と、取り込まれたログエントリを
Cloud Logging で表示する方法について説明します。
始める前に
このセクションでは、Telemetry API を使用するための環境を設定する方法について説明します。
プロジェクトを選択または作成する Google Cloud
この例では、 Google Cloud プロジェクトを選択します。プロジェクトがない場合は、次の手順で作成します。 Google Cloud
- アカウントにログインします。 Google Cloud を初めて使用する場合は、 アカウントを作成して、 実際のシナリオでプロダクトがどのように機能するかを評価してください。 Google Cloud新規のお客様には、ワークロードの実行、テスト、デプロイに利用できる $300 分の無料クレジットも提供されます。
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
gcloud を設定する
gcloud ツールは Google Cloud CLI に含まれています。インストールの詳細については、
Google Cloud CLI コンポーネントの管理をご覧ください。
インストールされている gcloud CLI コンポーネントを確認するには、次のコマンドを実行します。
gcloud components list
使用するように gcloud CLI を構成するには、PROJECT_ID 変数をプロジェクトの識別子に置き換えてから、次のコマンドを実行します。Google Cloud
export GOOGLE_CLOUD_PROJECT=PROJECT_ID gcloud auth login gcloud config set project PROJECT_ID
API を有効にする
プロジェクトで Cloud Logging API と Telemetry API を有効にします。Google Cloud Telemetry API
に特に注意してくださいtelemetry.googleapis.com。このドキュメント
でこの API を初めて使用する可能性があります。
次のコマンドの出力に API が表示されている場合は、すでに有効になっています。
gcloud services list
いずれかの API が有効になっていない場合は、対応するコマンドを実行します。
gcloud services enable logging.googleapis.com gcloud services enable telemetry.googleapis.com
ログを書き込む権限を取得する
Telemetry API にログを書き込み、作成したログエントリを表示するために必要な権限を取得するには、プリンシパルに対する次の IAM ロールを付与するよう管理者に依頼します。
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。
Telemetry API を使用して OTLP ログを書き込む
このセクションでは、OTLP 形式のログレコードを作成し、curl ユーティリティを使用してレコードを Telemetry API に送信する方法について説明します。
OTLP ログを作成する
OTLP 形式のログレコードを含む JSON ファイルを作成します。次のタブには、非常にシンプルなログレコードと、より複雑なマルチログレコードが含まれています。 どちらかを選択することも、それぞれを連続して送信することもできます。
シンプルな OTLP ログ
{
"resourceLogs": [
{
"resource": {
"attributes": [
{"key": "gcp.project_id", "value": {"stringValue": "PROJECT_ID"}},
{"key": "cloud.platform", "value": {"stringValue": "gcp_compute_engine"}},
{"key": "zone", "value": {"stringValue": "us-central1"}},
{"key": "instance_id", "value": {"stringValue": "12345"}},
]
},
"scopeLogs": [
{
"logRecords": [
{ "eventName": "otlp-test-log",
"body": { "stringValue": "This is a trivial log message." },
}
]
}
]
}
]
}
より複雑な OTLP ログ
{
"resourceLogs": [
{
"resource": {
"attributes": [
{"key": "gcp.project_id", "value": {"stringValue": "PROJECT_ID"}},
{"key": "cloud.platform", "value": {"stringValue": "gcp_compute_engine"}},
{"key": "zone", "value": {"stringValue": "us-central1"}},
{"key": "instance_id", "value": {"stringValue": "12345"}},
]
},
"scopeLogs": [
{
"logRecords": [
{ "eventName": "otlp-test-log",
"severityText": "INFO",
"body": { "stringValue": "This is an informational message." },
"attributes": [
{"key": "string.attribute",
"value": { "stringValue": "Here's some general info."}},
{"key": "int.attribute",
"value": { "intValue": "666"}},
{"key": "double.attribute",
"value": { "doubleValue": "3.14159"}},
{"key": "boolean.attribute",
"value": { "boolValue": true}},
]
},
{ "eventName": "otlp-test-log",
"severityText": "DEBUG",
"body": { "stringValue": "This is a debug message." },
"attributes": [
{"key": "string.attribute",
"value": { "stringValue": "Here's some debug info."}},
{"key": "int.attribute",
"value": { "intValue": "42"}},
{"key": "double.attribute",
"value": { "doubleValue": "6373.392"}},
{"key": "boolean.attribute",
"value": { "boolValue": false}},
]
}
]
}
]
}
]
}
いずれかのタブから JSON コンテンツをファイルにコピーして保存します。
これらの JSON の例では、どちらも Cloud Logging ログエントリが
gce_instance
モニタリング対象リソースタイプに対して書き込まれます。scopedLogs 配列の各 logRecord 項目は、OTLP ログレコードの eventName フィールドの値で名前が付けられたログ内の個別の Cloud Logging ログエントリになります。OTLP ログが Logging ログエントリにマッピングされる方法の詳細については、以下をご覧ください。
ログを Telemetry API に送信する
OTLP_LOG_JSON_FILE 変数を、作成したファイルの名前に置き換えてから、次の curl コマンドを使用して、ファイルの内容を Telemetry API のロギング エンドポイント https://telemetry.googleapis.com/v1/logs に投稿します。
curl -i -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" -H "X-Goog-User-Project: ${PROJECT_ID}" \
-d @OTLP_LOG_JSON_FILE \
"https://telemetry.googleapis.com/v1/logs"
JSON ログレコードのファイルを複数作成する場合は、
OTLP_LOG_JSON_FILE 変数を curl コマンドの必ず変更してください。
curl コマンドは一連のメッセージを生成し、成功した場合は空のレスポンス（{}）を生成します。出力は次のようになります。
HTTP/2 200
x-google-esf-cloud-client-params: backend_service_name: "telemetry.googleapis.com" backend_fully_qualified_method: "opentelemetry.proto.collector.logs.v1.LogsService.Export"
[...]
x-google-gfe-response-code-details-trace: response_code_set_by_backend
x-google-gfe-response-body-transformations: gunzipped,chunked
x-google-shellfish-status: CA0gBEBG
x-google-gfe-version: 2.970.1
alt-svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
accept-ranges: none
{}
取り込まれた OTLP ログを表示する
OTLP ログから生成されたログエントリは、ログ エクスプローラやオブザーバビリティ分析など、Cloud Logging の任意のツールを使用して表示できます。次のセクションでは、次の方法でログエントリを表示する方法について説明します。
gcloud を使用してログを表示する
作成したログエントリは、
gcloud logging read コマンドを使用して取得できます。
次のコマンドは、出力対象を過去 5 分間に書き込まれた otlp-test-log ログのログエントリに制限します。
gcloud logging read "LOG_ID(otlp-test-log)" --freshness=5m --format=json
サンプル OTLP ログに対応するログエントリは次のようになります。
シンプルなログエントリ
[
{
"insertId": "1yt9bu7a0",
"logName": "projects/PROJECT_ID/logs/otlp-test-log",
"otel": {
"resource": {
"attributes": {
"cloud.platform": "gcp_compute_engine",
"gcp.project_id": "PROJECT_ID",
"instance_id": "12345",
"zone": "us-central1"
}
}
},
"receiveTimestamp": "2026-03-18T20:17:00.128801819Z",
"resource": {
"labels": {
"instance_id": "12345",
"project_id": "PROJECT_ID",
"zone": "us-central1"
},
"type": "gce_instance"
},
"textPayload": "This is a trivial log message.",
"timestamp": "2026-03-18T20:17:00.128801819Z"
}
]
より複雑なログエントリ
[
{
"insertId": "1aw7fsja1",
"labels": {
"boolean.attribute": "false",
"double.attribute": "6373.39",
"int.attribute": "42",
"string.attribute": "Here's some debug info."
},
"logName": "projects/PROJECT_ID/logs/otlp-test-log",
"otel": {
"resource": {
"attributes": {
"cloud.platform": "gcp_compute_engine",
"gcp.project_id": "PROJECT_ID",
"instance_id": "12345",
"zone": "us-central1"
}
}
},
"receiveTimestamp": "2026-03-16T17:11:19.461096569Z",
"resource": {
"labels": {
"instance_id": "12345",
"project_id": "PROJECT_ID",
"zone": "us-central1"
},
"type": "gce_instance"
},
"severity": "DEBUG",
"textPayload": "This is a debug message.",
"timestamp": "2026-03-16T17:11:19.461096569Z"
},
{
"insertId": "1aw7fsja0",
"labels": {
"boolean.attribute": "true",
"double.attribute": "3.14159",
"int.attribute": "666",
"string.attribute": "Here's some general info."
},
"logName": "projects/PROJECT_ID/logs/otlp-test-log",
"otel": {
"resource": {
"attributes": {
"cloud.platform": "gcp_compute_engine",
"gcp.project_id": "PROJECT_ID",
"instance_id": "12345",
"zone": "us-central1"
}
}
},
"receiveTimestamp": "2026-03-16T17:11:19.461096569Z",
"resource": {
"labels": {
"instance_id": "12345",
"project_id": "PROJECT_ID",
"zone": "us-central1"
},
"type": "gce_instance"
},
"severity": "INFO",
"textPayload": "This is an informational message.",
"timestamp": "2026-03-16T17:11:19.461096569Z"
}
]
ログ エクスプローラを使用してログを表示する
コンソールで OTLP ログから作成されたログエントリを表示する手順は次のとおりです。 Google Cloud
-
コンソールで、セグメント [] ページに移動します。 Google Cloud
検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。
- OTLP ログを送信した Google Cloud プロジェクトを選択します。
[クエリ] ペインでクエリを入力します。このドキュメントのサンプルは、
otlp-test-logという名前のログに書き込まれます。このログのエントリを検索するには、次のクエリを入力します。LOG_ID(otlp-test-log)[クエリを実行] をクリックします。
クリーンアップ
新しいプロジェクトを作成して不要になった場合は、 プロジェクトを削除 して、アカウントへの課金を回避できます。 Google Cloud
次のステップ
Telemetry API の詳細については、次のドキュメントをご覧ください。
- API の概要では、 ログ、指標、トレースの Telemetry API について説明します。
- v1.logs では、ロギング用の Telemetry API エンドポイントについて説明し、 OTLP ログレコードが Cloud Logging ログエントリとして取り込まれる方法について詳しく説明します。