この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/semconv/resource/device/

翻訳元: open-telemetry/semantic-conventions v1.44.0(コミット e10a930

Device

Status: Development

type: device

Description: このリソースが表すプロセスが実行されているデバイス。

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

Attributes:

RoleKeyStabilityRequirement LevelValue TypeDescriptionExample Values
Otherdevice.manufacturerDevelopmentRecommendedstringデバイスの製造元の名前。[1]Apple; Samsung
Otherdevice.model.identifierDevelopmentRecommendedstringデバイスのモデル識別子。[2]iPhone3,4; SM-G920F
Otherdevice.model.nameDevelopmentRecommendedstringデバイスモデルのマーケティング名。[3]iPhone 6s Plus; Samsung Galaxy S6
Otherdevice.idDevelopmentOpt-Instringそのデバイスを表す一意の識別子。[4]123456789012345; 01:23:45:67:89:AB

[1] device.manufacturer: Android OSは、この項目をBuild経由で提供します。iOSアプリは値Appleをハードコードすべきです(SHOULD)。

[2] device.model.identifier: この値は、デバイスのマーケット向け・消費者向けの分かりやすい名前ではなく、機械可読なバージョンのモデル識別子を表すことが推奨されます。

[3] device.model.name: この値は、機械可読な代替表現ではなく、人間が読めるバージョンのデバイスモデルを表すことが推奨されます。

[4] device.id: その値は、デバイス上のすべてのアプリで同一であるべきであり(SHOULD)、アプリがアンインストールされて再インストールされても変化するべきではありません(SHOULD NOT)。 しかし、デバイス上のすべてのアプリに対して、ユーザーがリセットできる場合があります。 値としては、ハードウェアID(ベンダー固有のシリアル番号、IMEI、MACアドレスなど)を使ってもかまいません(MAY)。

Androidの識別子に関するベストプラクティスの詳細は、Androidユーザーデータ ID ガイドを参照してください。

[!WARNING]

この属性には機密(PII)情報が含まれる可能性があります。個人データやユーザーを識別できるものを保存する際は注意が必要です。GDPRやデータ保護法が適用される可能性があり、必ず自身で妥当性を確認してください。

これらの理由から、この識別子はコンシューマー向けアプリケーションには推奨されず、Google PlayとApp Storeの両方で拒否される可能性が高くなります。 しかし、キオスク端末や企業管理下のデバイスのような特定の企業向けシナリオでは、適切なコンプライアンス上の承認があれば適切な場合もあります。 この識別子を提供する計装は、オプトイン機能として実装しなければなりません(MUST)。

よりプライバシーに配慮した代替手段については、app.installation.idを参照してください。