

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Registro y supervisión en el SDK de Amazon Chime
<a name="monitoring-overview"></a>

La supervisión es una parte importante del mantenimiento de la fiabilidad, la disponibilidad y el rendimiento del SDK de Amazon Chime y del resto AWS de sus soluciones. AWS proporciona las siguientes herramientas para supervisar el SDK de Amazon Chime, informar de problemas y tomar medidas automáticas cuando proceda:
+ *Amazon CloudWatch* supervisa en tiempo real sus AWS recursos y las aplicaciones en las que se ejecuta AWS. Puede recopilar métricas y realizar un seguimiento de las métricas, crear paneles personalizados y definir alarmas que le advierten o que toman medidas cuando una métrica determinada alcanza el umbral que se especifique. Por ejemplo, puede CloudWatch hacer un seguimiento del uso de la CPU u otras métricas de sus instancias de Amazon EC2 y lanzar automáticamente nuevas instancias cuando sea necesario. Para obtener más información, consulta la [Guía del CloudWatch usuario de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
+ *Amazon EventBridge* ofrece un flujo casi en tiempo real de los eventos del sistema que describen los cambios en AWS los recursos. EventBridge permite la computación automatizada basada en eventos. Esto le permite escribir reglas que vigilen ciertos eventos y activar acciones automatizadas en otros AWS servicios cuando se producen estos eventos. Para obtener más información, consulta la [Guía del EventBridge usuario de Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/).
+ *Amazon CloudWatch Logs* le permite supervisar, almacenar y acceder a sus archivos de registro desde instancias de Amazon EC2 y otras fuentes. CloudTrail CloudWatch Los registros pueden monitorear la información de los archivos de registro y notificarle cuando se alcanzan ciertos umbrales. También se pueden archivar los datos del registro en un almacenamiento de larga duración. Para obtener más información, consulta la [Guía del usuario CloudWatch de Amazon Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/).
+ *AWS CloudTrail*captura las llamadas a la API y los eventos relacionados realizados por su AWS cuenta o en su nombre. A continuación, entrega los archivos log al bucket de Amazon S3 que se especifique. Puedes identificar qué usuarios y cuentas llamaron AWS, la dirección IP de origen desde la que se realizaron las llamadas y cuándo se produjeron. Para obtener más información, consulte la [Guía del usuario de AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).

**Topics**
+ [

# Supervisión del SDK de Amazon Chime con Amazon CloudWatch
](monitoring-cloudwatch.md)
+ [

# Automatizar el SDK de Amazon Chime con EventBridge
](automating-chime-with-cloudwatch-events.md)
+ [

# Se utiliza AWS CloudTrail para registrar las llamadas a la API
](cloudtrail.md)

# Supervisión del SDK de Amazon Chime con Amazon CloudWatch
<a name="monitoring-cloudwatch"></a>

Puede usarlo CloudWatch para monitorear el SDK de Amazon Chime. CloudWatch recopila datos sin procesar y los procesa para convertirlos en métricas legibles y prácticamente en tiempo real. Estas estadísticas se guardan durante 15 meses, para que pueda acceder a la información histórica y obtener una mejor perspectiva del rendimiento de su aplicación o servicio web. También puede establecer alarmas que vigilen determinados umbrales y enviar notificaciones o realizar acciones cuando se cumplan dichos umbrales. Para obtener más información, consulta la [Guía del CloudWatch usuario de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).

## CloudWatch métricas del SDK de Amazon Chime
<a name="cw-metrics"></a>

El SDK de Amazon Chime envía las siguientes métricas. CloudWatch El SDK de Amazon Chime envía las métricas una vez por minuto durante una llamada y envía todas las métricas que se muestran aquí.

El espacio de `AWS/ChimeVoiceConnector` nombres incluye las siguientes métricas para los números de teléfono asignados a su AWS cuenta y a los conectores de voz del SDK de Amazon Chime.

**nota**  
El SDK envía los valores de pérdida de paquetes una vez por minuto durante una llamada. Los valores de pérdida se acumulan durante la llamada. Por ejemplo, si se pierde un paquete a las 11:01, el valor de la pérdida se transfiere durante los minutos restantes de la llamada. Al final de la llamada, recibirá una única métrica de pérdida de paquetes.


| Métrica | Description (Descripción) | 
| --- | --- | 
|  `SmaActiveCallCount`  |  El número de llamadas simultáneas activas a la aplicación Sip Media. Unidades: recuento  | 
|  `VoiceConnectorActiveCallCount`  |  El número de llamadas simultáneas activas al Voice Connector. Unidades: recuento  | 
|  `InboundCallAttempts`  |  Número de llamadas entrantes intentadas. Unidades: recuento  | 
|  `InboundCallFailures`  |  El número de errores de llamadas entrantes. Unidades: recuento  | 
|  `InboundCallsAnswered`  |  El número de llamadas entrantes que se responden. Unidades: recuento  | 
|  `InboundCallsActive`  |  El número de llamadas entrantes que están activas actualmente. Unidades: recuento  | 
|  `OutboundCallAttempts`  |  Número de llamadas salientes intentadas. Unidades: recuento  | 
|  `OutboundCallFailures`  |  Número de errores de llamadas salientes. Unidades: recuento  | 
|  `OutboundCallsAnswered`  |  El número de llamadas salientes que se responden. Unidades: recuento  | 
|  `OutboundCallsActive`  |  El número de llamadas salientes que están activas actualmente. Unidades: recuento  | 
|  `Throttles`  |  El número de veces que su cuenta se limita al intentar realizar una llamada. Unidades: recuento  | 
|  `Sip1xxCodes`  |  El número de mensajes SIP con códigos de estado de 1xx-level. Unidades: recuento  | 
|  `Sip2xxCodes`  |  El número de mensajes SIP con códigos de estado de 2xx-level. Unidades: recuento  | 
|  `Sip3xxCodes`  |  El número de mensajes SIP con códigos de estado de 3xx-level. Unidades: recuento  | 
|  `Sip4xxCodes`  |  El número de mensajes SIP con códigos de estado de 4xx-level. Unidades: recuento  | 
|  `Sip5xxCodes`  |  El número de mensajes SIP con códigos de estado de 5xx-level. Unidades: recuento  | 
|  `Sip6xxCodes`  |  El número de mensajes SIP con códigos de estado de 6xx-level. Unidades: recuento  | 
|  `CustomerToVcRtpPackets`  |  La cantidad de paquetes RTP enviados por el cliente a la infraestructura del conector de voz del SDK de Amazon Chime. Unidades: recuento  | 
|  `CustomerToVcRtpBytes`  |  El número de bytes enviados desde el cliente a la infraestructura del conector de voz del SDK de Amazon Chime en paquetes RTP. Unidades: recuento  | 
|  `CustomerToVcRtcpPackets`  |  La cantidad de paquetes RTCP enviados por el cliente a la infraestructura del conector de voz del SDK de Amazon Chime. Unidades: recuento  | 
|  `CustomerToVcRtcpBytes`  |  El número de bytes enviados por el cliente a la infraestructura del conector de voz del SDK de Amazon Chime en paquetes RTCP. Unidades: recuento  | 
|  `CustomerToVcPacketsLost`  |  La cantidad de paquetes perdidos en tránsito del cliente a la infraestructura del conector de voz del SDK de Amazon Chime. Los valores se envían cada minuto hasta que finaliza la llamada. El recuento de valores es acumulativo. Unidades: recuento  | 
|  `CustomerToVcJitter`  |  La fluctuación media de los paquetes enviados por el cliente a la infraestructura del conector de voz del SDK de Amazon Chime. Unidades: microsegundos  | 
|  `VcToCustomerRtpPackets`  |  La cantidad de paquetes RTP enviados al cliente desde la infraestructura del conector de voz del SDK de Amazon Chime. Unidades: recuento  | 
|  `VcToCustomerRtpBytes`  |  El número de bytes enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al cliente en paquetes RTP. Unidades: recuento  | 
|  `VcToCustomerRtcpPackets`  |  La cantidad de paquetes RTCP enviados al cliente desde la infraestructura del conector de voz del SDK de Amazon Chime. Unidades: recuento  | 
|  `VcToCustomerRtcpBytes`  |  El número de bytes enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al cliente en paquetes RTCP. Unidades: recuento  | 
|  `VcToCustomerPacketsLost`  |  La cantidad de paquetes perdidos en tránsito desde la infraestructura del conector de voz del SDK de Amazon Chime hasta el cliente. Los valores se envían cada minuto hasta que finaliza la llamada. El recuento de valores es acumulativo. Unidades: recuento  | 
|  `VcToCustomerJitter`  |  La fluctuación media de los paquetes enviados al cliente desde la infraestructura del conector de voz del SDK de Amazon Chime. Unidades: microsegundos  | 
|  `RTTBetweenVcAndCustomer`  |  El tiempo medio de ida y vuelta entre el cliente y la infraestructura del conector de voz del SDK de Amazon Chime. Unidades: microsegundos  | 
|  `MOSBetweenVcAndCustomer`  |  La puntuación media de opinión (MOS) estimada asociada a las transmisiones de voz entre el cliente y la infraestructura de conectores de voz del SDK de Amazon Chime. Unidades: puntuación entre 1.0 y 4.4. Una puntuación más alta indica una calidad de audio con mejor percepción.  | 
|  `RemoteToVcRtpPackets`  |  La cantidad de paquetes RTP enviados desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime. Unidades: recuento  | 
|  `RemoteToVcRtpBytes`  |  El número de bytes enviados desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime en paquetes RTP. Unidades: recuento  | 
|  `RemoteToVcRtcpPackets`  |  La cantidad de paquetes RTCP enviados desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime. Unidades: recuento  | 
|  `RemoteToVcRtcpBytes`  |  El número de bytes enviados desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime en paquetes RTCP. Unidades: recuento  | 
|  `RemoteToVcPacketsLost`  |  La cantidad de paquetes perdidos en tránsito desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime. Los valores se envían cada minuto hasta que finaliza la llamada. El recuento de valores es acumulativo. Unidades: recuento  | 
|  `RemoteToVcJitter`  |  La fluctuación media de los paquetes enviados desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime. Unidades: microsegundos  | 
|  `VcToRemoteRtpPackets`  |  La cantidad de paquetes RTP enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al extremo remoto. Unidades: recuento  | 
|  `VcToRemoteRtpBytes`  |  El número de bytes enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al extremo remoto en paquetes RTP. Unidades: recuento  | 
|  `VcToRemoteRtcpPackets`  |  La cantidad de paquetes RTCP enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al extremo remoto. Unidades: recuento  | 
|  `VcToRemoteRtcpBytes`  |  El número de bytes enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al extremo remoto en paquetes RTCP. Unidades: recuento  | 
|  `VcToRemotePacketsLost`  |  La cantidad de paquetes perdidos en tránsito desde la infraestructura del conector de voz del SDK de Amazon Chime hasta el extremo remoto. Los valores se envían cada minuto hasta que finaliza la llamada. El recuento de valores es acumulativo. Unidades: recuento  | 
|  `VcToRemoteJitter`  |  La fluctuación media de los paquetes enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al extremo remoto. Unidades: microsegundos  | 
|  `RTTBetweenVcAndRemote`  |  El tiempo medio de ida y vuelta entre el extremo remoto y la infraestructura del conector de voz del SDK de Amazon Chime. Unidades: microsegundos  | 
|  `MOSBetweenVcAndRemote`  |  La puntuación media de opinión (MOS) estimada asociada a las transmisiones de voz entre el extremo remoto y la infraestructura de conectores de voz del SDK de Amazon Chime. Unidades: puntuación entre 1.0 y 4.4. Una puntuación más alta indica una calidad de audio con mejor percepción.  | 

## CloudWatch dimensiones del SDK de Amazon Chime
<a name="cw-dimensions"></a>

Las CloudWatch dimensiones que puede usar con el SDK de Amazon Chime se muestran a continuación.


| Dimensión | Description (Descripción) | 
| --- | --- | 
|  `VoiceConnectorId`  |  El identificador del conector de voz del SDK de Amazon Chime para mostrar las métricas.  | 
|  `Region`  |  La AWS región asociada al evento.  | 

## CloudWatch registros para el SDK de Amazon Chime
<a name="cw-logs"></a>

Puede configurar sus conectores de voz del SDK de Amazon Chime para enviar métricas a CloudWatch Logs. Cuando lo haga, también podrá recibir registros de métricas con calidad multimedia para esos conectores de voz.

El SDK de Amazon Chime envía métricas detalladas una vez por minuto. El SDK de Amazon Chime los envía para todas las llamadas realizadas con los conectores de voz configurados y los envía a un grupo de CloudWatch registros que creamos para usted. 

El nombre del grupo de registros usa este formato:`/aws/ChimeVoiceConnectorLogs/${VoiceConnectorID}`.

Para obtener más información sobre la configuración de los conectores de voz para enviar métricas, consulte[Edición de la configuración del conector de voz del SDK de Amazon Chime](edit-voicecon.md).

**nota**  
Las métricas de pérdida de paquetes se acumulan durante la llamada. Por ejemplo, si se pierde un paquete a las 11:01, el valor de la pérdida se transfiere durante los minutos restantes de la llamada. Al final de la llamada, recibirá una única métrica de pérdida de paquetes.

El SDK de Amazon Chime incluye los siguientes campos en los registros, en formato JSON.


| Campo | Description (Descripción) | 
| --- | --- | 
|  voice\$1connector\$1id  |  El identificador del conector de voz del SDK de Amazon Chime que contiene la llamada.  | 
|  event\$1timestamp  |  Hora a la que se emiten las métricas, en número de milisegundos desde la fecha de inicio UNIX (medianoche del 1 de enero de 1970) en UTC.  | 
|  call\$1id  |  Corresponde al identificador de la transacción.  | 
|  from\$1sip\$1user  |  El usuario que inicia la llamada.  | 
|  from\$1country  |  El país de inicio de la llamada.  | 
|  to\$1sip\$1user  |  El usuario receptor de la llamada.  | 
|  to\$1country  |  El país receptor de la llamada.  | 
|  endpoint\$1id  |  Identificador opaco que indica el otro punto de enlace de la llamada. Úselo con CloudWatch Logs Insights. Para obtener más información, consulte [Análisis de datos de registro con CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) en la *Guía del usuario de Amazon CloudWatch Logs*.  | 
|  aws\$1region  |  La AWS región de la llamada.  | 
|  cust2vc\$1rtp\$1packets  |  La cantidad de paquetes RTP enviados por el cliente a la infraestructura del conector de voz del SDK de Amazon Chime.  | 
|  cust2vc\$1rtp\$1bytes  |  El número de bytes enviados desde el cliente a la infraestructura del conector de voz del SDK de Amazon Chime en paquetes RTP.  | 
|  cust2vc\$1rtcp\$1packets  |  La cantidad de paquetes RTCP enviados por el cliente a la infraestructura del conector de voz del SDK de Amazon Chime.  | 
|  cust2vc\$1rtcp\$1bytes  |  El número de bytes enviados por el cliente a la infraestructura del conector de voz del SDK de Amazon Chime en paquetes RTCP.  | 
|  cust2vc\$1packets\$1lost  |  La cantidad de paquetes perdidos en tránsito del cliente a la infraestructura del conector de voz del SDK de Amazon Chime. Los valores se envían cada minuto hasta que finaliza la llamada. El recuento de valores es acumulativo.  | 
|  cust2vc\$1jitter  |  La fluctuación media de los paquetes enviados por el cliente a la infraestructura del conector de voz del SDK de Amazon Chime.  | 
|  vc2cust\$1rtp\$1packets  |  La cantidad de paquetes RTP enviados al cliente desde la infraestructura del conector de voz del SDK de Amazon Chime.  | 
|  vc2cust\$1rtp\$1bytes  |  El número de bytes enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al cliente en paquetes RTP.  | 
|  vc2cust\$1rtcp\$1packets  |  La cantidad de paquetes RTCP enviados al cliente desde la infraestructura del conector de voz del SDK de Amazon Chime.  | 
|  vc2cust\$1rtcp\$1bytes  |  El número de bytes enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al cliente en paquetes RTCP.  | 
|  vc2cust\$1packets\$1lost  |  La cantidad de paquetes perdidos en tránsito desde la infraestructura del conector de voz del SDK de Amazon Chime hasta el cliente. Los valores se envían cada minuto hasta que finaliza la llamada. El recuento de valores es acumulativo.  | 
|  vc2cust\$1jitter  |  La fluctuación media de los paquetes enviados al cliente desde la infraestructura del conector de voz del SDK de Amazon Chime.  | 
|  rtt\$1btwn\$1vc\$1and\$1cust  |  El tiempo medio de ida y vuelta entre el cliente y la infraestructura del conector de voz del SDK de Amazon Chime.  | 
|  mos\$1btwn\$1vc\$1and\$1cust  |  La puntuación media de opinión (MOS) estimada asociada a las transmisiones de voz entre el cliente y la infraestructura de conectores de voz del SDK de Amazon Chime.  | 
|  rem2vc\$1rtp\$1packets  |  La cantidad de paquetes RTP enviados desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime.  | 
|  rem2vc\$1rtp\$1bytes  |  El número de bytes enviados desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime en paquetes RTP.  | 
|  rem2vc\$1rtcp\$1packets  |  La cantidad de paquetes RTCP enviados desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime.  | 
|  rem2vc\$1rtcp\$1bytes  |  El número de bytes enviados desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime en paquetes RTCP.  | 
|  rem2vc\$1packets\$1lost  |  La cantidad de paquetes perdidos en tránsito desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime. Los valores se envían cada minuto hasta que finaliza la llamada. El recuento de valores es acumulativo.  | 
|  rem2vc\$1jitter  |  La fluctuación media de los paquetes enviados desde el extremo remoto a la infraestructura del conector de voz del SDK de Amazon Chime.  | 
|  vc2rem\$1rtp\$1packets  |  La cantidad de paquetes RTP enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al extremo remoto.  | 
|  vc2rem\$1rtp\$1bytes  |  El número de bytes enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al extremo remoto en paquetes RTP.  | 
|  vc2rem\$1rtcp\$1packets  |  La cantidad de paquetes RTCP enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al extremo remoto.  | 
|  vc2rem\$1rtcp\$1bytes  |  El número de bytes enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al extremo remoto en paquetes RTCP.  | 
|  vc2rem\$1packets\$1lost  |  La cantidad de paquetes perdidos en tránsito desde la infraestructura del conector de voz del SDK de Amazon Chime hasta el extremo remoto. Los valores se envían cada minuto hasta que finaliza la llamada. El recuento de valores es acumulativo.  | 
|  vc2rem\$1jitter  |  La fluctuación media de los paquetes enviados desde la infraestructura del conector de voz del SDK de Amazon Chime al extremo remoto.  | 
|  rtt\$1btwn\$1vc\$1and\$1rem  |  El tiempo medio de ida y vuelta entre el extremo remoto y la infraestructura del conector de voz del SDK de Amazon Chime.  | 
|  mos\$1btwn\$1vc\$1and\$1rem  |  La puntuación media de opinión (MOS) estimada asociada a las transmisiones de voz entre el extremo remoto y la infraestructura de conectores de voz del SDK de Amazon Chime.  | 

**Registros de mensajes SIP**  
Puede optar por recibir registros de mensajes SIP para su conector de voz del SDK de Amazon Chime. Cuando lo hace, el SDK de Amazon Chime captura los mensajes SIP entrantes y salientes y los envía a un grupo de CloudWatch registros creado para usted. El nombre del grupo de registros es `/aws/ChimeVoiceConnectorSipMessages/${VoiceConnectorID}`. Los siguientes campos se incluyen en los registros, en formato JSON.


| Campo | Description (Descripción) | 
| --- | --- | 
|  voice\$1connector\$1id  |  El ID del conector de voz de Amazon Chime SDK.  | 
|  aws\$1region  |  La AWS región asociada al evento.  | 
|  event\$1timestamp  |  Hora a la que se captura el mensaje, en número de milisegundos desde la fecha de inicio UNIX (medianoche del 1 de enero de 1970) en UTC.  | 
|  call\$1id  |  El identificador de llamada del conector de voz del SDK de Amazon Chime.  | 
|  sip\$1message  |  El mensaje SIP completo que se captura.  | 

# Automatizar el SDK de Amazon Chime con EventBridge
<a name="automating-chime-with-cloudwatch-events"></a>

Amazon EventBridge le permite automatizar sus AWS servicios y responder automáticamente a los eventos del sistema, como problemas de disponibilidad de las aplicaciones o cambios en los recursos. Para obtener más información sobre los eventos de la reunión, consulte los [eventos de la reunión](https://docs.aws.amazon.com/chime/latest/dg/using-events.html) en la Guía para *desarrolladores del SDK de Amazon Chime*.

Cuando el SDK de Amazon Chime genera eventos, los envía a EventBridge para que se entreguen al *máximo*, lo que significa que el SDK de Amazon Chime intenta enviar todos los eventos EventBridge a, pero en raras ocasiones es posible que un evento no se entregue. Para obtener más información, consulta la sección [Eventos de AWS los servicios](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) en la *Guía del EventBridge usuario de Amazon*.

**nota**  
Si necesita cifrar datos, debe utilizar claves gestionadas por Amazon S3. No admitimos el cifrado del lado del servidor con las claves maestras del cliente almacenadas en el servicio de administración de AWS claves. 

## Automatización de los conectores de voz del SDK de Amazon Chime con EventBridge
<a name="events-cvc"></a>

Entre las acciones que se pueden activar automáticamente para los conectores de voz del SDK de Amazon Chime se incluyen las siguientes:
+ Invocar una función AWS Lambda 
+ Lanzamiento de una tarea de Amazon Elastic Container Service
+ Desvío del evento a Amazon Kinesis Video Streams
+ Activar una máquina de AWS Step Functions estados
+ Notificar un tema de Amazon SNS o una cola de Amazon SQS

Algunos ejemplos de uso EventBridge con los conectores de voz del SDK de Amazon Chime incluyen:
+ Activación de una función de Lambda para descargar audio de una llamada una vez finalizada la llamada.
+ Lanzamiento de una tarea de Amazon ECS para habilitar la transcripción en tiempo real después de iniciar una llamada.

Para obtener más información, consulta la [Guía del EventBridge usuario de Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/).

## Eventos de streaming del Amazon Chime SDK Voice Connector
<a name="stream-events-cvc"></a>

Los conectores de voz del SDK de Amazon Chime admiten el envío de eventos al EventBridge momento en que se producen los eventos descritos en esta sección.

### Comienza la transmisión del conector de voz del SDK de Amazon Chime
<a name="stream-start-cvc"></a>

Los conectores de voz del SDK de Amazon Chime envían este evento cuando se inicia la transmisión de contenido multimedia a Kinesis Video Streams.

**Example Datos de evento**  
El siguiente es un ejemplo de los datos de este evento.  

```
{
    "version": "0",
    "id": "12345678-1234-1234-1234-111122223333",
    "detail-type": "Chime VoiceConnector Streaming Status",
    "source": "aws.chime",
    "account": "111122223333",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "callId": "1112-2222-4333",
        "direction": "Outbound",
        "fromNumber": "+12065550100",
        "inviteHeaders": {
            "from": "\"John\" <sip:+12065550100@10.24.34.0>;tag=abcdefg",
            "to": "<sip:+13605550199@abcdef1ghij2klmno3pqr4M.voiceconnector.chime.aws:5060>",
            "call-id": "1112-2222-4333",
            "cseq": "101 INVITE",
            "contact": "<sip:user@10.24.34.0:6090>;",
            "content-type": "application/sdp",
            "content-length": "246"
        },
        "isCaller": false,
        "mediaType": "audio/L16",
        "sdp": {
            "mediaIndex": 0,
            "mediaLabel": "1"
        },
        "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>;\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
        "startFragmentNumber": "1234567899444",
        "startTime": "yyyy-mm-ddThh:mm:ssZ",
        "streamArn": "arn:aws:kinesisvideo:us-east-1:123456M:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333",
        "toNumber": "+13605550199",
        "transactionId": "12345678-1234-1234",
        "voiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "streamingStatus": "STARTED",
        "version": "0"
    }
}
```

### Finaliza la transmisión del conector de voz Amazon Chime SDK
<a name="stream-end-cvc"></a>

Los conectores de voz del SDK de Amazon Chime envían este evento cuando finaliza la transmisión multimedia a Kinesis Video Streams.

**Example Datos de evento**  
El siguiente es un ejemplo de los datos de este evento.  

```
{
    "version": "0",
    "id": "12345678-1234-1234-1234-111122223333",
    "detail-type": "Chime VoiceConnector Streaming Status",
    "source": "aws.chime",
    "account": "111122223333",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "streamingStatus": "ENDED",
        "voiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "transactionId": "12345678-1234-1234",
        "callId": "1112-2222-4333",
        "direction": "Inbound",
        "fromNumber": "+12065550100",
        "inviteHeaders": {
            "from": "\"John\" <sip:+12065550100@10.24.34.0>;tag=abcdefg",
            "to": "<sip:+13605550199@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws:5060>",
            "call-id": "1112-2222-4333",
            "cseq": "101 INVITE",
            "contact": "<sip:user@10.24.34.0:6090>",
            "content-type": "application/sdp",
            "content-length": "246"
        },
        "isCaller": false,
        "mediaType": "audio/L16",
        "sdp": {
            "mediaIndex": 0,
            "mediaLabel": "1"
        },
        "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
        "startFragmentNumber": "1234567899444",
        "startTime": "yyyy-mm-ddThh:mm:ssZ",
        "endTime": "yyyy-mm-ddThh:mm:ssZ",
        "streamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333",
        "toNumber": "+13605550199",
        "version": "0"
    }
}
```

### Actualizaciones de streaming del conector de voz del SDK de Amazon Chime
<a name="stream-update-cvc"></a>

Los conectores de voz del SDK de Amazon Chime envían este evento cuando se actualiza la transmisión multimedia a Kinesis Video Streams.

**Example Datos de evento**  
El siguiente es un ejemplo de los datos de este evento.  

```
{
    "version": "0",
    "id": "12345678-1234-1234-1234-111122223333",
    "detail-type": "Chime VoiceConnector Streaming Status",
    "source": "aws.chime",
    "account": "111122223333",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "callId": "1112-2222-4333",
        "updateHeaders": {
            "from": "\"John\" <sip:+12065550100@10.24.34.0>;;tag=abcdefg",
            "to": "<sip:+13605550199@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws:5060>",
            "call-id": "1112-2222-4333",
            "cseq": "101 INVITE",
            "contact": "<sip:user@10.24.34.0:6090>",
            "content-type": "application/sdp",
            "content-length": "246"
        },
        "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
        "streamingStatus": "UPDATED",
        "transactionId": "12345678-1234-1234",
        "version": "0",
        "voiceConnectorId": "abcdef1ghij2klmno3pqr4"
    }
}
```

### Se produce un error en la transmisión del conector de voz del SDK de Amazon Chime
<a name="stream-fail-cvc"></a>

Los conectores de voz del SDK de Amazon Chime envían este evento cuando se produce un error en la transmisión de contenido multimedia a Kinesis Video Streams.

**Example Datos de evento**  
El siguiente es un ejemplo de los datos de este evento.  

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-111122223333",
  "detail-type": "Chime VoiceConnector Streaming Status",
  "source": "aws.chime",
  "account": "111122223333",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "region": "us-east-1",
  "resources": [],
  "detail": {
       "streamingStatus":"FAILED",
       "voiceConnectorId":"abcdefghi",
       "transactionId":"12345678-1234-1234",
       "callId":"1112-2222-4333",
       "direction":"Inbound",
       "failTime":"yyyy-mm-ddThh:mm:ssZ",
       "failureReason": "Internal failure",
       "version":"0"
  }
}
```

# Se utiliza AWS CloudTrail para registrar las llamadas a la API
<a name="cloudtrail"></a>

El SDK de Amazon Chime está integrado con AWS CloudTrail un servicio que proporciona un registro de las acciones realizadas en el SDK de Amazon Chime por un usuario, rol o servicio. AWS CloudTrail captura todas las llamadas a la API del SDK de Amazon Chime como eventos, incluidas las llamadas desde la consola del SDK de Amazon Chime y las llamadas de código al SDK de Amazon Chime. APIs

Si crea una ruta, puede habilitar la entrega continua de CloudTrail eventos a un bucket de Amazon S3, incluidos los eventos del SDK de Amazon Chime. Si no configura una ruta, podrá ver los eventos más recientes en la CloudTrail consola, en la página del **historial de eventos**. La información incluye cada solicitud, las direcciones IP desde las que se realizaron las solicitudes y quién las realizó.

CloudTrail está habilitada en su AWS cuenta al crear la cuenta. Cuando la consola de administración de Amazon Chime realiza una llamada a la API, CloudTrail registra esa actividad en un evento. Para ver los eventos, inicie la CloudTrail consola y vaya al **Historial de eventos**. Puedes ver, buscar y descargar los eventos recientes en tu AWS cuenta. Para obtener más información, consulta Cómo [ver eventos con el historial de CloudTrail eventos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). 

Para obtener más información CloudTrail, consulte la [Guía AWS CloudTrail del usuario](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).

## Creating a trail
<a name="create-trail"></a>

En los temas siguientes se explica cómo utilizar la CloudTrail consola para crear un sendero. De forma predeterminada, cuando crea una ruta en la consola, la ruta registra los eventos de todas las regiones de la AWS partición y envía los archivos de registro al bucket de Amazon S3 que especifique.

Siga estos temas en el orden indicado.

1. [Introducción a la creación de registros de seguimiento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)

1. [CloudTrail servicios e integraciones compatibles](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)

1. [Configuración de las notificaciones de Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)

1. [Recibir archivos de CloudTrail registro de varias regiones](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) y [recibir archivos de CloudTrail registro de varias cuentas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

## Datos capturados por un sendero
<a name="cloudtrail-data"></a>

CloudTrail registra todas las acciones del SDK de Amazon Chime. Para obtener información sobre las acciones, consulte la referencia de la [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/Welcome.html). Por ejemplo, las llamadas a la [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meetings-chime_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meetings-chime_CreateAttendee.html)acción generan entradas en los archivos de CloudTrail registro. Cada evento contiene información sobre quién generó la solicitud. La información de identidad del usuario lo ayuda a determinar lo siguiente: 
+ Si la solicitud se realizó con las credenciales raíz o del usuario de IAM.
+ Si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado.
+ Si la solicitud la realizó otro AWS servicio.

Para obtener más información, consulte el [elemento userIdentity de CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

## Descripción de las entradas de los archivos de registro del SDK de Amazon Chime
<a name="understanding-service-name-entries"></a>

Un rastro es una configuración que permite la entrega de eventos como archivos de registro a un bucket de Amazon S3 que usted especifique. CloudTrail Los archivos de registro contienen una o más entradas de registro. Un evento representa una única solicitud de cualquier origen e incluye información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etcétera. Los archivos de registro de CloudTrail no son un rastro de la pila ordenada de las llamadas a la API públicas, por lo que no aparecen en ningún orden específico. 

Las entradas del SDK de Amazon Chime se identifican mediante la fuente de eventos **chime.amazonaws.com**.

Si ha configurado Active Directory para su cuenta del SDK de Amazon Chime, consulte [Registro de llamadas a la API de AWS Directory Service mediante](https://docs.aws.amazon.com/directoryservice/latest/devguide/cloudtrail_logging.html). CloudTrail En este artículo se describe cómo supervisar los problemas que puedan afectar a la capacidad de inicio de sesión de los usuarios del SDK de Amazon Chime. 

El siguiente ejemplo muestra una entrada de CloudTrail registro para el SDK de Amazon Chime:

```
{"eventVersion":"1.05",
         "userIdentity":{  
            "type":"IAMUser",
            "principalId":"AAAAAABBBBBBBBEXAMPLE",
            "arn":"arn:aws:iam::123456789012:user/Alice",
            "accountId":"0123456789012",
            "accessKeyId":"AAAAAABBBBBBBBEXAMPLE",
            "sessionContext":{  
               "attributes":{  
                  "mfaAuthenticated":"false",
                  "creationDate":"2017-07-24T17:57:43Z"
               },
               "sessionIssuer":{  
                  "type":"Role",
                  "principalId":"AAAAAABBBBBBBBEXAMPLE",
                  "arn":"arn:aws:iam::123456789012:role/Joe",
                  "accountId":"123456789012",
                  "userName":"Joe"
               }
            }
         } ,
         "eventTime":"2017-07-24T17:58:21Z",
         "eventSource":"chime.amazonaws.com",
         "eventName":"AddDomain",
         "awsRegion":"us-east-1",
         "sourceIPAddress":"72.21.198.64",
         "userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36",
         "errorCode":"ConflictException",
         "errorMessage":"Request could not be completed due to a conflict",
         "requestParameters":{  
            "domainName":"example.com",
            "accountId":"11aaaaaa1-1a11-1111-1a11-aaadd0a0aa00"
         },
         "responseElements":null,
         "requestID":"be1bee1d-1111-11e1-1eD1-0dc1111f1ac1",
         "eventID":"00fbeee1-123e-111e-93e3-11111bfbfcc1",
         "eventType":"AwsApiCall",
         "recipientAccountId":"123456789012"
      }
```