Builder class

Pacote:

@microsoft/agents-a365-observability

Builder para configurar o Agent 365 com rastreamento OpenTelemetry

Métodos

build()	Constrói e inicializa a configuração do Agente 365
shutdown()	Desliga o SDK do OpenTelemetry
start()	Inicia o SDK OpenTelemetry
withClusterCategory(ClusterCategory)	Configura a categoria do cluster para exportador Agent 365
withConfigurationProvider(IConfigurationProvider<ObservabilityConfiguration>)	Configura o fornecedor de configuração para o ObservabilityConfiguration. Quando definido, este fornecedor é usado pelo construtor e pelos seus componentes internos, em vez do fornecedor padrão que lê das variáveis do ambiente.
withCustomLogger(ILogger)	Define uma implementação de logger personalizada para o SDK de observabilidade
withExporterOptions(Partial<Agent365ExporterOptions>)	Forneça um conjunto parcial de Agent365ExporterOptions. Estes serão fundidos com os valores predefinidos e qualquer clusterCategory/tokenResolver explicitamente configurado.
withService(string, string)	Configura o nome e a versão do serviço para telemetria
withServiceNamespace(string)	Configura o namespace de serviço para telemetria (atributo de recurso service.namespace)
withTokenResolver(TokenResolver)	Configura o resolvedor de tokens para o exportador Agent 365

Detalhes de Método

build()

Constrói e inicializa a configuração do Agente 365

function build(): boolean

Devoluções

boolean

A instância NodeSDK configurada

shutdown()

Desliga o SDK do OpenTelemetry

function shutdown(): Promise<void>

Devoluções

Promise<void>

start()

Inicia o SDK OpenTelemetry

function start()

withClusterCategory(ClusterCategory)

Configura a categoria do cluster para exportador Agent 365

function withClusterCategory(clusterCategory: ClusterCategory): ObservabilityBuilder

Parâmetros

clusterCategory

ClusterCategory

A categoria cluster (por exemplo, "preprod", "prod")

Devoluções

Builder

A instância builder para cadeia de métodos

withConfigurationProvider(IConfigurationProvider<ObservabilityConfiguration>)

Configura o fornecedor de configuração para o ObservabilityConfiguration. Quando definido, este fornecedor é usado pelo construtor e pelos seus componentes internos, em vez do fornecedor padrão que lê das variáveis do ambiente.

function withConfigurationProvider(configProvider: IConfigurationProvider<ObservabilityConfiguration>): ObservabilityBuilder

Parâmetros

configProvider

IConfigurationProvider<ObservabilityConfiguration>

O fornecedor de configuração

Devoluções

Builder

A instância builder para cadeia de métodos

withCustomLogger(ILogger)

Define uma implementação de logger personalizada para o SDK de observabilidade

function withCustomLogger(customLogger: ILogger): ObservabilityBuilder

Parâmetros

customLogger

ILogger

A implementação do logger personalizado (deve implementar a interface ILogger)

Devoluções

Builder

A instância builder para cadeia de métodos

Exemplo com Winston:

const winstonLogger = winston.createLogger({...});
builder.withCustomLogger({
  info: (msg, ...args) => winstonLogger.info(msg, ...args),
  warn: (msg, ...args) => winstonLogger.warn(msg, ...args),
  error: (msg, ...args) => winstonLogger.error(msg, ...args)
});

withExporterOptions(Partial<Agent365ExporterOptions>)

Forneça um conjunto parcial de Agent365ExporterOptions. Estes serão fundidos com os valores predefinidos e qualquer clusterCategory/tokenResolver explicitamente configurado.

function withExporterOptions(exporterOptions: Partial<Agent365ExporterOptions>): ObservabilityBuilder

Parâmetros

exporterOptions

Partial<Agent365ExporterOptions>

Opções parciais para exportadores

Devoluções

Builder

A instância builder para encadeamento

withService(string, string)

Configura o nome e a versão do serviço para telemetria

function withService(serviceName: string, serviceVersion?: string): ObservabilityBuilder

Parâmetros

serviceName

string

O nome do serviço

serviceVersion

string

A versão de serviço

Devoluções

Builder

A instância builder para cadeia de métodos

withServiceNamespace(string)

Configura o namespace de serviço para telemetria (atributo de recurso service.namespace)

function withServiceNamespace(serviceNamespace: string): ObservabilityBuilder

Parâmetros

serviceNamespace

string

O espaço de nomes do serviço

Devoluções

Builder

A instância builder para cadeia de métodos

withTokenResolver(TokenResolver)

Configura o resolvedor de tokens para o exportador Agent 365

function withTokenResolver(tokenResolver: TokenResolver): ObservabilityBuilder

Parâmetros

tokenResolver

TokenResolver

Função para resolver tokens de autenticação

Devoluções

Builder

A instância builder para cadeia de métodos