この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/semconv/resource/cloud-provider/gcp/apphub/
翻訳元: open-telemetry/semantic-conventions v1.44.0(コミット e10a930)
Google Cloud AppHub
Status: Development
これらの規約は、AppHubを使用する際に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を参照してください。
Application
Status:
type: gcp.apphub.application
Description: AppHub内のApplicationからのデータを示す属性。AppHub overviewを参照してください。
[!warning] このEntity定義には、ロールを持たない属性が含まれています。 安定版のEntityは、ロールが定義されていない属性を持ってはなりません(MUST NOT)。
Attributes:
| Role | Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|---|
| Other | gcp.apphub.application.container | Required | string | AppHubアプリケーションが定義されているGCP内のコンテナ。 | projects/my-container-project | |
| Other | gcp.apphub.application.id | Required | string | AppHubで設定されているアプリケーションの名前。 | my-application | |
| Other | gcp.apphub.application.location | Required | string | アプリケーションが定義されているGCPのゾーンまたはリージョン。 | us-central1 |
Service
Status:
type: gcp.apphub.service
Description: AppHub内のServiceからのデータを示す属性。AppHub overviewを参照してください。
[!warning] このEntity定義には、ロールを持たない属性が含まれています。 安定版のEntityは、ロールが定義されていない属性を持ってはなりません(MUST NOT)。
Attributes:
| Role | Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|---|
| Other | gcp.apphub.service.criticality_type | Required | string | サービスの重要度は、そのサービスがビジネスにとってどれだけ重要かを示します。[1] | MISSION_CRITICAL; HIGH; MEDIUM | |
| Other | gcp.apphub.service.environment_type | Required | string | サービスの環境は、そのソフトウェアライフサイクルの段階を示します。[2] | PRODUCTION; STAGING; TEST | |
| Other | gcp.apphub.service.id | Required | string | AppHubで設定されているサービスの名前。 | my-service |
[1] gcp.apphub.service.criticality_type: AppHubのtype enumを参照
[2] gcp.apphub.service.environment_type: AppHubのenvironment typeを参照
gcp.apphub.service.criticality_type には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず(MUST)、それ以外の場合は独自の値を使ってもかまいません(MAY)。
| Value | Description | Stability |
|---|---|---|
HIGH | 影響度が高い。 | |
LOW | 影響度が低い。 | |
MEDIUM | 影響度が中程度。 | |
MISSION_CRITICAL | ミッションクリティカルなサービス。 |
gcp.apphub.service.environment_type には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず(MUST)、それ以外の場合は独自の値を使ってもかまいません(MAY)。
| Value | Description | Stability |
|---|---|---|
DEVELOPMENT | 開発環境。 | |
PRODUCTION | 本番環境。 | |
STAGING | ステージング環境。 | |
TEST | テスト環境。 |
Workload
Status:
type: gcp.apphub.workload
Description: AppHub内のWorkloadからのデータを示す属性。AppHub overviewを参照してください。
[!warning] このEntity定義には、ロールを持たない属性が含まれています。 安定版のEntityは、ロールが定義されていない属性を持ってはなりません(MUST NOT)。
Attributes:
| Role | Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|---|
| Other | gcp.apphub.workload.criticality_type | Required | string | ワークロードの重要度は、そのワークロードがビジネスにとってどれだけ重要かを示します。[1] | MISSION_CRITICAL; HIGH; MEDIUM | |
| Other | gcp.apphub.workload.environment_type | Required | string | ワークロードの環境は、そのソフトウェアライフサイクルの段階を示します。[2] | PRODUCTION; STAGING; TEST | |
| Other | gcp.apphub.workload.id | Required | string | AppHubで設定されているワークロードの名前。 | my-workload |
[1] gcp.apphub.workload.criticality_type: AppHubのtype enumを参照
[2] gcp.apphub.workload.environment_type: AppHubのenvironment typeを参照
gcp.apphub.workload.criticality_type には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず(MUST)、それ以外の場合は独自の値を使ってもかまいません(MAY)。
| Value | Description | Stability |
|---|---|---|
HIGH | 影響度が高い。 | |
LOW | 影響度が低い。 | |
MEDIUM | 影響度が中程度。 | |
MISSION_CRITICAL | ミッションクリティカルなサービス。 |
gcp.apphub.workload.environment_type には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず(MUST)、それ以外の場合は独自の値を使ってもかまいません(MAY)。
| Value | Description | Stability |
|---|---|---|
DEVELOPMENT | 開発環境。 | |
PRODUCTION | 本番環境。 | |
STAGING | ステージング環境。 | |
TEST | テスト環境。 |