New Relic の OpenTelemetry リソース

OpenTelemetry からのすべてのデータはリソースに関連付けられています。 リソースは、リソース属性としてテレメトリを生成するエンティティの表現です。 リソース属性は、リソースを New Relic のエンティティの概念に適合させるために使用されます。

受信されたデータは、エンティティ合成と呼ばれるプロセスを通じてエンティティに関連付けられます。このプロセスでは、存在するリソース属性が、データが関連付けられるエンティティのタイプを決定するルールと照合されます。 OpenTelemetry から取得されるデータの場合、エンティティ合成ルールは OpenTelemetryリソースのセマンティック規則を尊重するように設計されています。

リソース セマンティック規則は、さまざまな種類のエンティティを記述するためのさまざまな規則の集合を定義します。 たとえば、サービス規則とホスト規則は、それぞれサービスまたはホスト インスタンスを記述するリソース属性を定義します。

サポートされているエンティティタイプ

New Relicここでは、OpenTelemetry インストゥルメンテーションを使用するときにサポートされる オブジェクト タイプについて説明します。サポートされている各エンティティ タイプには次のものが含まれます。

• エンティティ合成に必要なリソース属性。
• New Relic UI の特定の側面を制御する推奨属性。
• 存在する場合、 エンティティ タグとなる属性。

サービス

サービス エンティティは、サービス インスタンスを記述する OpenTelemetry リソースのセマンティック規則に従って合成されます。

OpenTelemetry を使用してサービス エンティティを監視する方法については、ドキュメントと例を参照してください。

必要な属性

• service.name : UI に表示されるサービス名はこの値から取得されます。

推奨属性

• service.instance.id : 同じサービスの複数のインスタンス間のファセットを有効にします。
• telemetry.sdk.language : この値が存在する場合、Java アプリケーションの JVM ランタイム ページなど、ランタイム固有の UI の表示が制御されます。

エンティティタグ

• service.namespace
• telemetry.sdk.language (言語タグとして追加)
• telemetry.sdk.version
• k8s.cluster.name
• k8s.namespace.name
• k8s.deployment.name

ホスト

ホスト エンティティは、ホストを記述する OpenTelemetry リソースのセマンティック規則に従って合成されます。

詳細については、インフラストラクチャ モニタリングのコレクターのホスト監視の例を参照してください。

必要な属性

• host.name : UI に表示されるホスト名はこの値から取得されます。
• host.id

エンティティタグ

• cloud.provider
• cloud.account.id
• cloud.region
• cloud.availability_zone
• cloud.platform
• host.id
• host.name
• host.type
• host.arch
• host.image.name
• host.image.id
• host.image.version

Redisインスタンス

Redis インスタンスは、コレクターRedis レシーバーから発行されたデータを使用して合成されます。 残念ながら、現在、 Redisにはセマンティック規則がなく、 Redisレシーバーが発行するメトリック内の属性を識別する規則もありません。 したがって、ユーザーは以下に説明する属性を手動で含める必要があります。

詳細については、Redis インフラストラクチャモニタリング用コレクター の の例を参照してください。

必要な属性

• server.address : UI に表示される Redis インスタンス名はこの値から取得されます。
• server.port

エンティティタグ

• redis.version
• redis.role
• host.type
• cloud.provider
• cloud.account.id
• cloud.region
• instrumenation.name
• server.address
• server.port

サポートされているエンティティ関係

New Relic OpenTelemetryインストゥルメンテーションからソースされたエンティティ間のリレーションシップをサポートします。 これらの関係は、適切な関係基準が満たされると自動的に合成されます。 以下は現在サポートされている関係とその必要な基準です。

ホストへのサービス

サービスとホスト エンティティの関係では、サービスにhost.idリソース属性が含まれ、それが実行されているホストのhost.idと一致する必要があります。

エンティティにカスタムタグを追加する

タグを使用して、UI 内のエンティティを整理およびフィルターできます。タグは、監視対象のアプリやホストなどのさまざまなデータ セットに追加されるキーと値のペア (例: team: operationsです。アカウント ID など、特定の重要な属性はタグとして自動的に使用可能になります。独自のカスタム タグをUI に直接追加するか、以下のいずれかの方法を使用して追加することもできます。

tagsで始まるリソース属性を追加すると、New Relic のエンティティにタグが付けられます。 たとえば、属性tags.mytag=myvalueを追加すると、エンティティ タグmytag=myvalueが生成されます。