> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/resource/cloud-provider/gcp/apphub/ # Google Cloud AppHub **Status**: [Development][DocumentStatus] これらの規約は、[AppHub](https://cloud.google.com/app-hub/docs/overview)を使用する際にGoogle Cloudが使用します。Google Cloudからのオブザーバビリティデータは、テレメトリーの発生元に応じて、これらのリソース種別で注釈付けされます。例えば、Google Cloudのサービスから発生するメトリクスには、AppHubで設定されたとおりの適切な `gcp.apphub.application` および `gcp.apphub.service` が注釈付けされます。 各 `gcp.apphub.*` 属性には、対応する `gcp.apphub_destination.*` 属性があり、これは複数のAppHubコンポーネントを参照できるテレメトリーの宛先・依存先のアプリケーション・サービス・ワークロードを記述することに注意してください。 例えば、`CLIENT` スパンには、クライアント側の操作が実行されていたアプリケーションを記述する `gcp.apphub.*` 属性と、そのクライアントが通信していたアプリケーションを記述する `gcp.apphub_destination.*` 属性の両方が含まれる場合があります。 Google Cloudによってどのデータが注釈付けされるかについては、[Supported Resources](https://cloud.google.com/app-hub/docs/supported-resources)を参照してください。 ## Application **Status:** ![Development](https://img.shields.io/badge/-development-blue) **type:** `gcp.apphub.application` **Description:** AppHub内のApplicationからのデータを示す属性。[AppHub overview](https://cloud.google.com/app-hub/docs/overview)を参照してください。 > [!warning] > このEntity定義には、ロールを持たない属性が含まれています。 > 安定版のEntityは、ロールが定義されていない属性を持ってはなりません（MUST NOT）。 **Attributes:** | Role | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | --- | | Other | [`gcp.apphub.application.container`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/gcp/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | AppHubアプリケーションが定義されているGCP内のコンテナ。 | `projects/my-container-project` | | Other | [`gcp.apphub.application.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/gcp/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | AppHubで設定されているアプリケーションの名前。 | `my-application` | | Other | [`gcp.apphub.application.location`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/gcp/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | アプリケーションが定義されているGCPのゾーンまたはリージョン。 | `us-central1` | ## Service **Status:** ![Development](https://img.shields.io/badge/-development-blue) **type:** `gcp.apphub.service` **Description:** AppHub内のServiceからのデータを示す属性。[AppHub overview](https://cloud.google.com/app-hub/docs/overview)を参照してください。 > [!warning] > このEntity定義には、ロールを持たない属性が含まれています。 > 安定版のEntityは、ロールが定義されていない属性を持ってはなりません（MUST NOT）。 **Attributes:** | Role | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | --- | | Other | [`gcp.apphub.service.criticality_type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/gcp/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | サービスの重要度は、そのサービスがビジネスにとってどれだけ重要かを示します。[1] | `MISSION_CRITICAL`; `HIGH`; `MEDIUM` | | Other | [`gcp.apphub.service.environment_type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/gcp/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | サービスの環境は、そのソフトウェアライフサイクルの段階を示します。[2] | `PRODUCTION`; `STAGING`; `TEST` | | Other | [`gcp.apphub.service.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/gcp/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | AppHubで設定されているサービスの名前。 | `my-service` | **[1] `gcp.apphub.service.criticality_type`:** [AppHubのtype enumを参照](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type) **[2] `gcp.apphub.service.environment_type`:** [AppHubのenvironment typeを参照](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type_1) --- `gcp.apphub.service.criticality_type` には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず（MUST）、それ以外の場合は独自の値を使ってもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `HIGH` | 影響度が高い。 | ![Development](https://img.shields.io/badge/-development-blue) | | `LOW` | 影響度が低い。 | ![Development](https://img.shields.io/badge/-development-blue) | | `MEDIUM` | 影響度が中程度。 | ![Development](https://img.shields.io/badge/-development-blue) | | `MISSION_CRITICAL` | ミッションクリティカルなサービス。 | ![Development](https://img.shields.io/badge/-development-blue) | --- `gcp.apphub.service.environment_type` には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず（MUST）、それ以外の場合は独自の値を使ってもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `DEVELOPMENT` | 開発環境。 | ![Development](https://img.shields.io/badge/-development-blue) | | `PRODUCTION` | 本番環境。 | ![Development](https://img.shields.io/badge/-development-blue) | | `STAGING` | ステージング環境。 | ![Development](https://img.shields.io/badge/-development-blue) | | `TEST` | テスト環境。 | ![Development](https://img.shields.io/badge/-development-blue) | ## Workload **Status:** ![Development](https://img.shields.io/badge/-development-blue) **type:** `gcp.apphub.workload` **Description:** AppHub内のWorkloadからのデータを示す属性。[AppHub overview](https://cloud.google.com/app-hub/docs/overview)を参照してください。 > [!warning] > このEntity定義には、ロールを持たない属性が含まれています。 > 安定版のEntityは、ロールが定義されていない属性を持ってはなりません（MUST NOT）。 **Attributes:** | Role | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | --- | | Other | [`gcp.apphub.workload.criticality_type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/gcp/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | ワークロードの重要度は、そのワークロードがビジネスにとってどれだけ重要かを示します。[1] | `MISSION_CRITICAL`; `HIGH`; `MEDIUM` | | Other | [`gcp.apphub.workload.environment_type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/gcp/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | ワークロードの環境は、そのソフトウェアライフサイクルの段階を示します。[2] | `PRODUCTION`; `STAGING`; `TEST` | | Other | [`gcp.apphub.workload.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/gcp/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | AppHubで設定されているワークロードの名前。 | `my-workload` | **[1] `gcp.apphub.workload.criticality_type`:** [AppHubのtype enumを参照](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type) **[2] `gcp.apphub.workload.environment_type`:** [AppHubのenvironment typeを参照](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type_1) --- `gcp.apphub.workload.criticality_type` には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず（MUST）、それ以外の場合は独自の値を使ってもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `HIGH` | 影響度が高い。 | ![Development](https://img.shields.io/badge/-development-blue) | | `LOW` | 影響度が低い。 | ![Development](https://img.shields.io/badge/-development-blue) | | `MEDIUM` | 影響度が中程度。 | ![Development](https://img.shields.io/badge/-development-blue) | | `MISSION_CRITICAL` | ミッションクリティカルなサービス。 | ![Development](https://img.shields.io/badge/-development-blue) | --- `gcp.apphub.workload.environment_type` には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず（MUST）、それ以外の場合は独自の値を使ってもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `DEVELOPMENT` | 開発環境。 | ![Development](https://img.shields.io/badge/-development-blue) | | `PRODUCTION` | 本番環境。 | ![Development](https://img.shields.io/badge/-development-blue) | | `STAGING` | ステージング環境。 | ![Development](https://img.shields.io/badge/-development-blue) | | `TEST` | テスト環境。 | ![Development](https://img.shields.io/badge/-development-blue) | [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status