OpenTelemetryRealtimeClientBuilderExtensions.UseOpenTelemetry Método

Definición

Espacio de nombres:
Microsoft.Extensions.AI
Ensamblado:
Microsoft.Extensions.AI.dll
Paquete:
Microsoft.Extensions.AI v10.4.1
Source:
OpenTelemetryRealtimeClientBuilderExtensions.cs

Agrega compatibilidad con OpenTelemetry a la canalización de cliente en tiempo real, siguiendo las convenciones semánticas de OpenTelemetry para sistemas de inteligencia artificial generativa.

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

El RealtimeClientBuilder.

loggerFactory
ILoggerFactory

ILoggerFactory Opcional para crear un registrador para registrar eventos.

sourceName
String

Nombre de origen opcional que se usará en los datos de telemetría.

configure
Action<OpenTelemetryRealtimeClient>

Devolución de llamada opcional que se puede usar para configurar la OpenTelemetryRealtimeClient instancia.

Devoluciones

RealtimeClientBuilder

El builder.

Excepciones

ArgumentNullException

builder es null.

Comentarios

La especificación de borrador siguiente está disponible en https://opentelemetry.io/docs/specs/semconv/gen-ai/. La especificación sigue siendo experimental y está sujeta a cambios; como tal, la salida de telemetría de este cliente también está sujeta a cambios.

Se admiten las siguientes convenciones estándar de OpenTelemetry GenAI:

  • gen_ai.operation.name - Nombre de la operación ("tiempo real")
  • gen_ai.request.model - Nombre del modelo de las opciones
  • gen_ai.provider.name - Nombre del proveedor de metadatos
  • gen_ai.response.id - Id. de respuesta de los mensajes ResponseDone
  • gen_ai.usage.input_tokens - Recuento de tokens de entrada
  • gen_ai.usage.output_tokens - Recuento de tokens de salida
  • gen_ai.request.max_tokens - Número máximo de tokens de salida de las opciones
  • gen_ai.system_instructions - Instrucciones de opciones (datos confidenciales)
  • gen_ai.conversation.id - Identificador de conversación de la respuesta
  • gen_ai.tool.definitions - Definiciones de herramientas (datos confidenciales)
  • server.address / server.port - Información del punto de conexión del servidor
  • error.type - Tipo de error en errores

Además, se admiten los siguientes atributos personalizados específicos del tiempo real:

  • gen_ai.realtime.voice - Configuración de voz de las opciones
  • gen_ai.realtime.output_modalities - Modalidades de salida (texto, audio)
  • gen_ai.realtime.voice_speed - Configuración de velocidad de voz
  • gen_ai.realtime.session_kind - Tipo de sesión (tiempo real/transcripción)

Las métricas incluyen:

  • gen_ai.client.operation.duration - Histograma de duración
  • gen_ai.client.token.usage - Histograma de uso de tokens

Se aplica a