この記事は英語の原文を日本語に翻訳したものです。原文: 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: Development

type: gcp.apphub.application

Description: AppHub内のApplicationからのデータを示す属性。AppHub overviewを参照してください。

[!warning] このEntity定義には、ロールを持たない属性が含まれています。 安定版のEntityは、ロールが定義されていない属性を持ってはなりません(MUST NOT)。

Attributes:

RoleKeyStabilityRequirement LevelValue TypeDescriptionExample Values
Othergcp.apphub.application.containerDevelopmentRequiredstringAppHubアプリケーションが定義されているGCP内のコンテナ。projects/my-container-project
Othergcp.apphub.application.idDevelopmentRequiredstringAppHubで設定されているアプリケーションの名前。my-application
Othergcp.apphub.application.locationDevelopmentRequiredstringアプリケーションが定義されているGCPのゾーンまたはリージョン。us-central1

Service

Status: Development

type: gcp.apphub.service

Description: AppHub内のServiceからのデータを示す属性。AppHub overviewを参照してください。

[!warning] このEntity定義には、ロールを持たない属性が含まれています。 安定版のEntityは、ロールが定義されていない属性を持ってはなりません(MUST NOT)。

Attributes:

RoleKeyStabilityRequirement LevelValue TypeDescriptionExample Values
Othergcp.apphub.service.criticality_typeDevelopmentRequiredstringサービスの重要度は、そのサービスがビジネスにとってどれだけ重要かを示します。[1]MISSION_CRITICAL; HIGH; MEDIUM
Othergcp.apphub.service.environment_typeDevelopmentRequiredstringサービスの環境は、そのソフトウェアライフサイクルの段階を示します。[2]PRODUCTION; STAGING; TEST
Othergcp.apphub.service.idDevelopmentRequiredstringAppHubで設定されているサービスの名前。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)。

ValueDescriptionStability
HIGH影響度が高い。Development
LOW影響度が低い。Development
MEDIUM影響度が中程度。Development
MISSION_CRITICALミッションクリティカルなサービス。Development

gcp.apphub.service.environment_type には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず(MUST)、それ以外の場合は独自の値を使ってもかまいません(MAY)。

ValueDescriptionStability
DEVELOPMENT開発環境。Development
PRODUCTION本番環境。Development
STAGINGステージング環境。Development
TESTテスト環境。Development

Workload

Status: Development

type: gcp.apphub.workload

Description: AppHub内のWorkloadからのデータを示す属性。AppHub overviewを参照してください。

[!warning] このEntity定義には、ロールを持たない属性が含まれています。 安定版のEntityは、ロールが定義されていない属性を持ってはなりません(MUST NOT)。

Attributes:

RoleKeyStabilityRequirement LevelValue TypeDescriptionExample Values
Othergcp.apphub.workload.criticality_typeDevelopmentRequiredstringワークロードの重要度は、そのワークロードがビジネスにとってどれだけ重要かを示します。[1]MISSION_CRITICAL; HIGH; MEDIUM
Othergcp.apphub.workload.environment_typeDevelopmentRequiredstringワークロードの環境は、そのソフトウェアライフサイクルの段階を示します。[2]PRODUCTION; STAGING; TEST
Othergcp.apphub.workload.idDevelopmentRequiredstringAppHubで設定されているワークロードの名前。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)。

ValueDescriptionStability
HIGH影響度が高い。Development
LOW影響度が低い。Development
MEDIUM影響度が中程度。Development
MISSION_CRITICALミッションクリティカルなサービス。Development

gcp.apphub.workload.environment_type には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず(MUST)、それ以外の場合は独自の値を使ってもかまいません(MAY)。

ValueDescriptionStability
DEVELOPMENT開発環境。Development
PRODUCTION本番環境。Development
STAGINGステージング環境。Development
TESTテスト環境。Development