BaggageBuilder class

Par générateur de bagages de demande pour la propagation du contexte OpenTelemetry.

Cette classe fournit une API Fluent pour définir les valeurs de bagages qui seront propagées dans le contexte OpenTelemetry.

Exemple

const scope = new BaggageBuilder()
  .tenantId("tenant-123")
  .agentId("agent-456")
  .build();

scope.enter();
// Baggage is set in this context
// ... do work ...
scope.exit();
// Baggage is restored after exiting the context

Méthodes

agentAuid(undefined | null | string)

Définissez la valeur des bagages AUID de l’agent.

agentBlueprintId(undefined | null | string)

Définissez la valeur de bagage de l’ID de blueprint de l’agent.

agentDescription(undefined | null | string)

Définissez la valeur des bagages de description de l’agent.

agentEmail(undefined | null | string)

Définissez la valeur des bagages par e-mail de l’agent.

agentId(undefined | null | string)

Définissez la valeur de bagage de l’ID d’agent.

agentName(undefined | null | string)

Définissez la valeur des bagages du nom de l’agent.

agentPlatformId(undefined | null | string)

Définissez la valeur des bagages d’ID de plateforme de l’agent.

agentVersion(undefined | null | string)

Définissez la valeur des bagages de version de l’agent.

build()

Appliquez les bagages collectés au contexte actuel.

callerAgentPlatformId(undefined | null | string)

Définissez la valeur des bagages d’ID de plateforme de l’agent appelant.

callerClientIp(undefined | null | string)

Définissez la valeur des bagages IP du client de l’appelant. Permet de capturer l’adresse IP du client d’origine pour la requête afin qu’elle puisse être propagée via les bagages OpenTelemetry.

channelLink(undefined | null | string)

Définissez le lien/l’URL du canal.

channelName(undefined | null | string)

Définissez le nom du canal (par exemple, Teams, Slack).

conversationId(undefined | null | string)

Définissez la valeur des bagages d’ID de conversation.

conversationItemLink(undefined | null | string)

Définissez la valeur des bagages du lien d’élément de conversation.

invokeAgentServer(undefined | null | string, number)

Définit l’adresse du serveur de l’agent invoke et les valeurs des bagages de port.

operationSource(undefined | null | string)

Définissez la valeur du bagage source de l’opération. Utilisé pour les étendues de serveur pour identifier le service (par exemple, ATG, ACF).

sessionDescription(undefined | null | string)

Définissez la valeur des bagages de description de session.

sessionId(string)

Définissez la valeur de bagage de l’ID de session.

setPairs(undefined | null | Record<string, any> | Iterable<[string, any]>)

Définissez plusieurs paires de bagages à partir d’un dictionnaire ou itérable.

setRequestContext(null | string, null | string)

Méthode pratique pour commencer une étendue de bagages de requête avec des champs communs.

tenantId(undefined | null | string)

Définissez la valeur des bagages d’ID de locataire.

userEmail(undefined | null | string)

Définissez la valeur des bagages par e-mail de l’utilisateur.

userId(undefined | null | string)

Définissez la valeur des bagages d’ID utilisateur.

userName(undefined | null | string)

Définissez la valeur des bagages du nom d’utilisateur.

Détails de la méthode

agentAuid(undefined | null | string)

Définissez la valeur des bagages AUID de l’agent.

function agentAuid(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

AUID de l’agent

Retours

Auto-chaînage de méthodes

agentBlueprintId(undefined | null | string)

Définissez la valeur de bagage de l’ID de blueprint de l’agent.

function agentBlueprintId(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

ID de blueprint de l’agent

Retours

Auto-chaînage de méthodes

agentDescription(undefined | null | string)

Définissez la valeur des bagages de description de l’agent.

function agentDescription(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

Description de l’agent

Retours

Auto-chaînage de méthodes

agentEmail(undefined | null | string)

Définissez la valeur des bagages par e-mail de l’agent.

function agentEmail(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

E-mail de l’agent

Retours

Auto-chaînage de méthodes

agentId(undefined | null | string)

Définissez la valeur de bagage de l’ID d’agent.

function agentId(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

ID de l’agent

Retours

Auto-chaînage de méthodes

agentName(undefined | null | string)

Définissez la valeur des bagages du nom de l’agent.

function agentName(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

Nom de l’agent

Retours

Auto-chaînage de méthodes

agentPlatformId(undefined | null | string)

Définissez la valeur des bagages d’ID de plateforme de l’agent.

function agentPlatformId(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

ID de la plateforme de l’agent

Retours

Auto-chaînage de méthodes

agentVersion(undefined | null | string)

Définissez la valeur des bagages de version de l’agent.

function agentVersion(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

Version de l’agent (par exemple, « 1.0.0 », « 2025-05-01 »)

Retours

Auto-chaînage de méthodes

build()

Appliquez les bagages collectés au contexte actuel.

function build(): BaggageScope

Retours

Gestionnaire de contexte qui restaure les bagages précédents à la sortie

callerAgentPlatformId(undefined | null | string)

Définissez la valeur des bagages d’ID de plateforme de l’agent appelant.

function callerAgentPlatformId(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

Identificateur de la plateforme de l’agent appelant

Retours

Auto-chaînage de méthodes

callerClientIp(undefined | null | string)

Définissez la valeur des bagages IP du client de l’appelant. Permet de capturer l’adresse IP du client d’origine pour la requête afin qu’elle puisse être propagée via les bagages OpenTelemetry.

function callerClientIp(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

Adresse IP du client de l’appelant

Retours

Auto-chaînage de méthodes

Définissez le lien/l’URL du canal.

function channelLink(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

Lien de canal

Retours

Auto-chaînage de méthodes

channelName(undefined | null | string)

Définissez le nom du canal (par exemple, Teams, Slack).

function channelName(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

Nom du canal

Retours

Auto-chaînage de méthodes

conversationId(undefined | null | string)

Définissez la valeur des bagages d’ID de conversation.

function conversationId(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

ID de conversation

Retours

Auto-chaînage de méthodes

Définissez la valeur des bagages du lien d’élément de conversation.

function conversationItemLink(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

Lien de l’élément de conversation

Retours

Auto-chaînage de méthodes

invokeAgentServer(undefined | null | string, number)

Définit l’adresse du serveur de l’agent invoke et les valeurs des bagages de port.

function invokeAgentServer(address: undefined | null | string, port?: number): BaggageBuilder

Paramètres

address

undefined | null | string

Adresse du serveur (nom d’hôte) du service d’agent cible.

port

number

Port de serveur facultatif. Enregistré uniquement lorsqu’il est différent de 443.

Retours

Instance du générateur actuel pour le chaînage de méthodes.

operationSource(undefined | null | string)

Définissez la valeur du bagage source de l’opération. Utilisé pour les étendues de serveur pour identifier le service (par exemple, ATG, ACF).

function operationSource(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

Source de l’opération

Retours

Auto-chaînage de méthodes

sessionDescription(undefined | null | string)

Définissez la valeur des bagages de description de session.

function sessionDescription(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

Description de la session

Retours

Auto-chaînage de méthodes

sessionId(string)

Définissez la valeur de bagage de l’ID de session.

function sessionId(value: string): BaggageBuilder

Paramètres

value

string

L’ID de session

Retours

Auto-chaînage de méthodes

setPairs(undefined | null | Record<string, any> | Iterable<[string, any]>)

Définissez plusieurs paires de bagages à partir d’un dictionnaire ou itérable.

function setPairs(pairs: undefined | null | Record<string, any> | Iterable<[string, any]>): BaggageBuilder

Paramètres

pairs

undefined | null | Record<string, any> | Iterable<[string, any]>

Dictionnaire ou itérable de paires clé-valeur

Retours

Auto-chaînage de méthodes

setRequestContext(null | string, null | string)

Méthode pratique pour commencer une étendue de bagages de requête avec des champs communs.

static function setRequestContext(tenantId?: null | string, agentId?: null | string): BaggageScope

Paramètres

tenantId

null | string

ID de locataire

agentId

null | string

ID de l’agent

Retours

Gestionnaire de contexte qui restaure les bagages précédents à la sortie

tenantId(undefined | null | string)

Définissez la valeur des bagages d’ID de locataire.

function tenantId(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

ID de locataire

Retours

Auto-chaînage de méthodes

userEmail(undefined | null | string)

Définissez la valeur des bagages par e-mail de l’utilisateur.

function userEmail(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

E-mail de l’utilisateur

Retours

Auto-chaînage de méthodes

userId(undefined | null | string)

Définissez la valeur des bagages d’ID utilisateur.

function userId(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

ID d’utilisateur

Retours

Auto-chaînage de méthodes

userName(undefined | null | string)

Définissez la valeur des bagages du nom d’utilisateur.

function userName(value: undefined | null | string): BaggageBuilder

Paramètres

value

undefined | null | string

Nom de l’utilisateur

Retours

Auto-chaînage de méthodes