OpenTelemetryRealtimeClientBuilderExtensions.UseOpenTelemetry Método

Definição

Namespace:
Microsoft.Extensions.AI
Assembly:
Microsoft.Extensions.AI.dll
Pacote:
Microsoft.Extensions.AI v10.4.1
Origem:
OpenTelemetryRealtimeClientBuilderExtensions.cs

Adiciona suporte opentelemetry ao pipeline de cliente em tempo real, seguindo as Convenções Semânticas OpenTelemetry para sistemas de IA Generative.

public static Microsoft.Extensions.AI.RealtimeClientBuilder UseOpenTelemetry(this Microsoft.Extensions.AI.RealtimeClientBuilder builder, Microsoft.Extensions.Logging.ILoggerFactory? loggerFactory = default, string? sourceName = default, Action<Microsoft.Extensions.AI.OpenTelemetryRealtimeClient>? configure = default);
static member UseOpenTelemetry : Microsoft.Extensions.AI.RealtimeClientBuilder * Microsoft.Extensions.Logging.ILoggerFactory * string * Action<Microsoft.Extensions.AI.OpenTelemetryRealtimeClient> -> Microsoft.Extensions.AI.RealtimeClientBuilder
<Extension()>
Public Function UseOpenTelemetry (builder As RealtimeClientBuilder, Optional loggerFactory As ILoggerFactory = Nothing, Optional sourceName As String = Nothing, Optional configure As Action(Of OpenTelemetryRealtimeClient) = Nothing) As RealtimeClientBuilder

Parâmetros

builder
RealtimeClientBuilder

O RealtimeClientBuilder.

loggerFactory
ILoggerFactory

Um opcional ILoggerFactory a ser usado para criar um agente para registrar eventos em log.

sourceName
String

Um nome de origem opcional que será usado nos dados de telemetria.

configure
Action<OpenTelemetryRealtimeClient>

Um retorno de chamada opcional que pode ser usado para configurar a OpenTelemetryRealtimeClient instância.

Retornos

RealtimeClientBuilder

O builder.

Exceções

ArgumentNullException

builder é null.

Comentários

A especificação de rascunho a seguir está disponível em https://opentelemetry.io/docs/specs/semconv/gen-ai/. A especificação ainda é experimental e está sujeita a alterações; como tal, a saída de telemetria por esse cliente também está sujeita a alterações.

Há suporte para as seguintes convenções padrão do OpenTelemetry GenAI:

  • gen_ai.operation.name - Nome da operação ("realtime")
  • gen_ai.request.model – Nome do modelo das opções
  • gen_ai.provider.name - Nome do provedor dos metadados
  • gen_ai.response.id - ID de resposta de mensagens ResponseDone
  • gen_ai.usage.input_tokens - Contagem de tokens de entrada
  • gen_ai.usage.output_tokens - Contagem de tokens de saída
  • gen_ai.request.max_tokens – Máximo de tokens de saída das opções
  • gen_ai.system_instructions - Instruções de opções (dados confidenciais)
  • gen_ai.conversation.id – ID da conversa da resposta
  • gen_ai.tool.definitions - Definições de ferramenta (dados confidenciais)
  • server.address / server.port - Informações do ponto de extremidade do servidor
  • error.type - Tipo de erro em falhas

Além disso, há suporte para os seguintes atributos personalizados específicos em tempo real:

  • gen_ai.realtime.voice – Configuração de voz a partir de opções
  • gen_ai.realtime.output_modalities – Modalidades de saída (texto, áudio)
  • gen_ai.realtime.voice_speed - Configuração de velocidade de voz
  • gen_ai.realtime.session_kind - Tipo de sessão (tempo real/transcrição)

As métricas incluem:

  • gen_ai.client.operation.duration - Histograma de duração
  • gen_ai.client.token.usage - Histograma de uso de token

Aplica-se a