**End of support notice**: On February 20, 2026, AWS will end support for the Amazon Chime service. After February 20, 2026, you will no longer be able to access the Amazon Chime console or Amazon Chime application resources. For more information, visit the [blog post](https://aws.amazon.com/blogs/messaging-and-targeting/update-on-support-for-amazon-chime/). **Note:** This does not impact the availability of the [Amazon Chime SDK service](https://aws.amazon.com/chime/chime-sdk/). # Logging and monitoring in Amazon Chime Monitoring is an important part of maintaining the reliability, availability, and performance of Amazon Chime and your other AWS solutions. AWS provides the following tools to monitor Amazon Chime, report issues, and take automatic actions when appropriate: + *Amazon CloudWatch* monitors in real time your AWS resources and the applications that you run on AWS. You can collect and track metrics, create customized dashboards, and set alarms that notify you or take actions when a specified metric reaches a threshold that you specify. For example, you can have CloudWatch track CPU usage or other metrics of your Amazon EC2 instances and automatically launch new instances when needed. For more information, see the [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/). + *Amazon EventBridge* delivers a near real-time stream of system events that describe changes in AWS resources. EventBridge enables automated event-driven computing. This lets you write rules that watch for certain events, and trigger automated actions in other AWS services when these events happen. For more information, see the [Amazon EventBridge User Guide](https://docs.aws.amazon.com/eventbridge/latest/userguide/). + *Amazon CloudWatch Logs* lets you monitor, store, and access your log files from Amazon EC2 instances, CloudTrail, and other sources. CloudWatch Logs can monitor information in the log files and notify you when certain thresholds are met. You can also archive your log data in highly durable storage. For more information, see the [Amazon CloudWatch Logs User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/). + *AWS CloudTrail* captures API calls and related events made by or on behalf of your AWS account. It then delivers the log files to an Amazon S3 bucket that you specify. You can identify which users and accounts called AWS, the source IP address from which the calls were made, and when the calls occurred. For more information, see the [AWS CloudTrail User Guide](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). **Topics** + [Monitoring Amazon Chime with Amazon CloudWatch](monitoring-cloudwatch.md) + [Automating Amazon Chime with EventBridge](automating-chime-with-cloudwatch-events.md) + [Logging Amazon Chime API calls with AWS CloudTrail](cloudtrail.md) # Monitoring Amazon Chime with Amazon CloudWatch You can monitor Amazon Chime using CloudWatch, which collects raw data and processes it into readable, near real-time metrics. These statistics are kept for 15 months, so that you can access historical information and gain a better perspective about how your web application or service is performing. You can also set alarms that watch for certain thresholds, and send notifications or take actions when those thresholds are met. For more information, see the [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/). ## CloudWatch metrics for Amazon Chime Amazon Chime sends the following metrics to CloudWatch. The `AWS/ChimeVoiceConnector` namespace includes the following metrics for phone numbers assigned to your AWS account and to Amazon Chime Voice Connectors. | Metric | Description | | --- | --- | | `InboundCallAttempts` | The number of inbound calls attempted. Units: Count | | `InboundCallFailures` | The number of inbound call failures. Units: Count | | `InboundCallsAnswered` | The number of inbound calls that are answered. Units: Count | | `InboundCallsActive` | The number of inbound calls that are currently active. Units: Count | | `OutboundCallAttempts` | The number of outbound calls attempted. Units: Count | | `OutboundCallFailures` | The number of outbound call failures. Units: Count | | `OutboundCallsAnswered` | The number of outbound calls that are answered. Units: Count | | `OutboundCallsActive` | The number of outbound calls that are currently active. Units: Count | | `Throttles` | The number of times your account is throttled when attempting to make a call. Units: Count | | `Sip1xxCodes` | The number of SIP messages with 1xx-level status codes. Units: Count | | `Sip2xxCodes` | The number of SIP messages with 2xx-level status codes. Units: Count | | `Sip3xxCodes` | The number of SIP messages with 3xx-level status codes. Units: Count | | `Sip4xxCodes` | The number of SIP messages with 4xx-level status codes. Units: Count | | `Sip5xxCodes` | The number of SIP messages with 5xx-level status codes. Units: Count | | `Sip6xxCodes` | The number of SIP messages with 6xx-level status codes. Units: Count | | `CustomerToVcRtpPackets` | The number of RTP packets sent from the customer to the Amazon Chime Voice Connector infrastructure. Units: Count | | `CustomerToVcRtpBytes` | The number of bytes sent from the customer to the Amazon Chime Voice Connector infrastructure in RTP packets. Units: Count | | `CustomerToVcRtcpPackets` | The number of RTCP packets sent from the customer to the Amazon Chime Voice Connector infrastructure. Units: Count | | `CustomerToVcRtcpBytes` | The number of bytes sent from the customer to the Amazon Chime Voice Connector infrastructure in RTCP packets. Units: Count | | `CustomerToVcPacketsLost` | The number of packets lost in transit from the customer to the Amazon Chime Voice Connector infrastructure. Units: Count | | `CustomerToVcJitter` | The average jitter for packets sent from the customer to the Amazon Chime Voice Connector infrastructure. Units: Microseconds | | `VcToCustomerRtpPackets` | The number of RTP packets sent from the Amazon Chime Voice Connector infrastructure to the customer. Units: Count | | `VcToCustomerRtpBytes` | The number of bytes sent from the Amazon Chime Voice Connector infrastructure to the customer in RTP packets. Units: Count | | `VcToCustomerRtcpPackets` | The number of RTCP packets sent from the Amazon Chime Voice Connector infrastructure to the customer. Units: Count | | `VcToCustomerRtcpBytes` | The number of bytes sent from the Amazon Chime Voice Connector infrastructure to the customer in RTCP packets. Units: Count | | `VcToCustomerPacketsLost` | The number of packets lost in transit from the Amazon Chime Voice Connector infrastructure to the customer. Units: Count | | `VcToCustomerJitter` | The average jitter for packets sent from the Amazon Chime Voice Connector infrastructure to the customer. Units: Microseconds | | `RTTBetweenVcAndCustomer` | The average round-trip time between the customer and the Amazon Chime Voice Connector infrastructure. Units: Microseconds | | `MOSBetweenVcAndCustomer` | The estimated Mean opinion score (MOS) associated with voice streams between the customer and the Amazon Chime Voice Connector infrastructure. Units: Score between 1.0-4.4. A higher score indicates better perceived audio quality. | | `RemoteToVcRtpPackets` | The number of RTP packets sent from the remote end to the Amazon Chime Voice Connector infrastructure. Units: Count | | `RemoteToVcRtpBytes` | The number of bytes sent from the remote end to the Amazon Chime Voice Connector infrastructure in RTP packets. Units: Count | | `RemoteToVcRtcpPackets` | The number of RTCP packets sent from the remote end to the Amazon Chime Voice Connector infrastructure. Units: Count | | `RemoteToVcRtcpBytes` | The number of bytes sent from the remote end to the Amazon Chime Voice Connector infrastructure in RTCP packets. Units: Count | | `RemoteToVcPacketsLost` | The number of packets lost in transit from the remote end to the Amazon Chime Voice Connector infrastructure. Units: Count | | `RemoteToVcJitter` | The average jitter for packets sent from the remote end to the Amazon Chime Voice Connector infrastructure. Units: Microseconds | | `VcToRemoteRtpPackets` | The number of RTP packets sent from the Amazon Chime Voice Connector infrastructure to the remote end. Units: Count | | `VcToRemoteRtpBytes` | The number of bytes sent from the Amazon Chime Voice Connector infrastructure to the remote end in RTP packets. Units: Count | | `VcToRemoteRtcpPackets` | The number of RTCP packets sent from the Amazon Chime Voice Connector infrastructure to the remote end. Units: Count | | `VcToRemoteRtcpBytes` | The number of bytes sent from the Amazon Chime Voice Connector infrastructure to the remote end in RTCP packets. Units: Count | | `VcToRemotePacketsLost` | The number of packets lost in transit from the Amazon Chime Voice Connector infrastructure to the remote end. Units: Count | | `VcToRemoteJitter` | The average jitter for packets sent from the Amazon Chime Voice Connector infrastructure to the remote end. Units: Microseconds | | `RTTBetweenVcAndRemote` | The average round-trip time between the remote end and the Amazon Chime Voice Connector infrastructure. Units: Microseconds | | `MOSBetweenVcAndRemote` | The estimated Mean opinion score (MOS) associated with voice streams between the remote end and the Amazon Chime Voice Connector infrastructure. Units: Units: Score between 1.0-4.4. A higher score indicates better perceived audio quality. | ## CloudWatch dimensions for Amazon Chime The CloudWatch dimensions that you can use with Amazon Chime are listed as follows. | Dimension | Description | | --- | --- | | `VoiceConnectorId` | The identifier of the Amazon Chime Voice Connector to display metrics for. | | `Region` | The AWS Region associated with the event. | ## CloudWatch logs for Amazon Chime You can send Amazon Chime Voice Connector metrics to CloudWatch Logs. For more information, see [Editing Amazon Chime Voice Connector settings](https://docs.aws.amazon.com/chime-sdk/latest/ag/edit-voicecon.html) in the *Amazon Chime SDK Administration Guide*. **Media quality metric logs** You can opt to receive media quality metric logs for your Amazon Chime Voice Connector. When you do, Amazon Chime sends detailed, per-minute metrics for all of your Amazon Chime Voice Connector calls to a CloudWatch Logs log group that is created for you. The log group name is `/aws/ChimeVoiceConnectorLogs/${VoiceConnectorID}`. The following fields are included in the logs, in JSON format. | Field | Description | | --- | --- | | voice\$1connector\$1id | The Amazon Chime Voice Connector ID carrying the call. | | event\$1timestamp | The time when the metrics are emitted, in number of milliseconds since the UNIX epoch (midnight on January 1, 1970) in UTC. | | call\$1id | Corresponds to the Transaction ID. | | from\$1sip\$1user | The initiating user for the call. | | from\$1country | The initiating country for the call. | | to\$1sip\$1user | The receiving user for the call. | | to\$1country | The receiving country for the call. | | endpoint\$1id | An opaque identifier indicating the other endpoint of the call. Use with CloudWatch Logs Insights. For more information, see [Analyzing log data with CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) in the *Amazon CloudWatch Logs User Guide*. | | aws\$1region | The AWS Region for the call. | | cust2vc\$1rtp\$1packets | The number of RTP packets sent from the customer to the Amazon Chime Voice Connector infrastructure. | | cust2vc\$1rtp\$1bytes | The number of bytes sent from the customer to the Amazon Chime Voice Connector infrastructure in RTP packets. | | cust2vc\$1rtcp\$1packets | The number of RTCP packets sent from the customer to the Amazon Chime Voice Connector infrastructure. | | cust2vc\$1rtcp\$1bytes | The number of bytes sent from the customer to the Amazon Chime Voice Connector infrastructure in RTCP packets. | | cust2vc\$1packets\$1lost | The number of packets lost in transit from the customer to the Amazon Chime Voice Connector infrastructure. | | cust2vc\$1jitter | The average jitter for packets sent from the customer to the Amazon Chime Voice Connector infrastructure. | | vc2cust\$1rtp\$1packets | The number of RTP packets sent from the Amazon Chime Voice Connector infrastructure to the customer. | | vc2cust\$1rtp\$1bytes | The number of bytes sent from the Amazon Chime Voice Connector infrastructure to the customer in RTP packets. | | vc2cust\$1rtcp\$1packets | The number of RTCP packets sent from the Amazon Chime Voice Connector infrastructure to the customer. | | vc2cust\$1rtcp\$1bytes | The number of bytes sent from the Amazon Chime Voice Connector infrastructure to the customer in RTCP packets. | | vc2cust\$1packets\$1lost | The number of packets lost in transit from the Amazon Chime Voice Connector infrastructure to the customer. | | vc2cust\$1jitter | The average jitter for packets sent from the Amazon Chime Voice Connector infrastructure to the customer. | | rtt\$1btwn\$1vc\$1and\$1cust | The average round-trip time between the customer and the Amazon Chime Voice Connector infrastructure. | | mos\$1btwn\$1vc\$1and\$1cust | The estimated Mean opinion score (MOS) associated with voice streams between the customer and the Amazon Chime Voice Connector infrastructure. | | rem2vc\$1rtp\$1packets | The number of RTP packets sent from the remote end to the Amazon Chime Voice Connector infrastructure. | | rem2vc\$1rtp\$1bytes | The number of bytes sent from the remote end to the Amazon Chime Voice Connector infrastructure in RTP packets. | | rem2vc\$1rtcp\$1packets | The number of RTCP packets sent from the remote end to the Amazon Chime Voice Connector infrastructure. | | rem2vc\$1rtcp\$1bytes | The number of bytes sent from the remote end to the Amazon Chime Voice Connector infrastructure in RTCP packets. | | rem2vc\$1packets\$1lost | The number of packets lost in transit from the remote end to the Amazon Chime Voice Connector infrastructure. | | rem2vc\$1jitter | The average jitter for packets sent from the remote end to the Amazon Chime Voice Connector infrastructure. | | vc2rem\$1rtp\$1packets | The number of RTP packets sent from the Amazon Chime Voice Connector infrastructure to the remote end. | | vc2rem\$1rtp\$1bytes | The number of bytes sent from the Amazon Chime Voice Connector infrastructure to the remote end in RTP packets. | | vc2rem\$1rtcp\$1packets | The number of RTCP packets sent from the Amazon Chime Voice Connector infrastructure to the remote end. | | vc2rem\$1rtcp\$1bytes | The number of bytes sent from the Amazon Chime Voice Connector infrastructure to the remote end in RTCP packets. | | vc2rem\$1packets\$1lost | The number of packets lost in transit from the Amazon Chime Voice Connector infrastructure to the remote end. | | vc2rem\$1jitter | The average jitter for packets sent from the Amazon Chime Voice Connector infrastructure to the remote end. | | rtt\$1btwn\$1vc\$1and\$1rem | The average round-trip time between the remote end and the Amazon Chime Voice Connector infrastructure. | | mos\$1btwn\$1vc\$1and\$1rem | The estimated Mean opinion score (MOS) associated with voice streams between the remote end and the Amazon Chime Voice Connector infrastructure. | **SIP message logs** You can opt to receive SIP message logs for your Amazon Chime Voice Connector. When you do, Amazon Chime captures inbound and outbound SIP messages and sends them to a CloudWatch Logs log group that is created for you. The log group name is `/aws/ChimeVoiceConnectorSipMessages/${VoiceConnectorID}`. The following fields are included in the logs, in JSON format. | Field | Description | | --- | --- | | voice\$1connector\$1id | The Amazon Chime Voice Connector ID. | | aws\$1region | The AWS Region associated with the event. | | event\$1timestamp | The time when the message is captured, in number of milliseconds since the UNIX epoch (midnight on January 1, 1970) in UTC. | | call\$1id | The Amazon Chime Voice Connector call ID. | | sip\$1message | The full SIP message that is captured. | # Automating Amazon Chime with EventBridge Amazon EventBridge lets you automate your AWS services and respond automatically to system events, such as application availability issues or resource changes. For more information about the meeting events, see [Meeting events](https://docs.aws.amazon.com/chime/latest/dg/using-events.html) in the *Amazon Chime Developer Guide*. When Amazon Chime generates events, it sends them to EventBridge for *best effort delivery*, meaning Amazon Chime tries to send all events to EventBridge, but in rare cases an event might not be delivered. For more information, refer to [Events from AWS services](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) in the *Amazon EventBridge User Guide*. **Note** If you need to encrypt data, you must use Amazon S3-Managed Keys. We don't support server-side encryption using Customer Master Keys stored in the AWS Key Management Service. ## Automating Amazon Chime Voice Connectors with EventBridge The actions that can be automatically triggered for Amazon Chime Voice Connectors include the following: + Invoking an AWS Lambda function + Launching an Amazon Elastic Container Service task + Relaying the event to Amazon Kinesis Video Streams + Activating an AWS Step Functions state machine + Notifying an Amazon SNS topic or an Amazon SQS queue Some examples of using EventBridge with Amazon Chime Voice Connectors include: + Activating a Lambda function to download audio for a call after the call is ended. + Launching an Amazon ECS task to enable real-time transcription after a call is started. For more information, see the [Amazon EventBridge User Guide](https://docs.aws.amazon.com/eventbridge/latest/userguide/). ## Amazon Chime Voice Connector streaming events Amazon Chime Voice Connectors support sending events to EventBridge when the events discussed in this section occur. ### Amazon Chime Voice Connector streaming starts Amazon Chime Voice Connectors send this event when media streaming to Kinesis Video Streams starts. **Example Event data** The following is example data for this event. ``` { "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\" ;tag=abcdefg", "to": "", "call-id": "1112-2222-4333", "cseq": "101 INVITE", "contact": ";", "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", "startFragmentNumber": "1234567899444", "startTime": "yyyy-mm-ddThh:mm:ssZ", "streamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333", "toNumber": "+13605550199", "transactionId": "12345678-1234-1234", "voiceConnectorId": "abcdef1ghij2klmno3pqr4", "streamingStatus": "STARTED", "version": "0" } } ``` ### Amazon Chime Voice Connector streaming ends Amazon Chime Voice Connectors send this event when media streaming to Kinesis Video Streams ends. **Example Event data** The following is example data for this event. ``` { "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\" ;tag=abcdefg", "to": "", "call-id": "1112-2222-4333", "cseq": "101 INVITE", "contact": "", "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", "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" } } ``` ### Amazon Chime Voice Connector streaming updates Amazon Chime Voice Connectors send this event when media streaming to Kinesis Video Streams is updated. **Example Event data** The following is example data for this event. ``` { "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\" ;;tag=abcdefg", "to": "", "call-id": "1112-2222-4333", "cseq": "101 INVITE", "contact": "", "content-type": "application/sdp", "content-length": "246" }, "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n", "streamingStatus": "UPDATED", "transactionId": "12345678-1234-1234", "version": "0", "voiceConnectorId": "abcdef1ghij2klmno3pqr4" } } ``` ### Amazon Chime Voice Connector streaming fails Amazon Chime Voice Connectors send this event when media streaming to Kinesis Video Streams fails. **Example Event data** The following is example data for this event. ``` { "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" } } ``` # Logging Amazon Chime API calls with AWS CloudTrail Amazon Chime is integrated with AWS CloudTrail, a service that provides a record of actions taken by a user, role, or an AWS service in Amazon Chime. CloudTrail captures all API calls for Amazon Chime as events, including calls from the Amazon Chime console and from code calls to the Amazon Chime APIs. If you create a trail, you can enable continuous delivery of CloudTrail events to an Amazon S3 bucket, including events for Amazon Chime. If you don't configure a trail, you can still view the most recent events in the CloudTrail console in **Event history**. Using the information collected by CloudTrail, you can determine the request that was made to Amazon Chime, the IP address from which the request was made, who made the request, when it was made, and additional details. To learn more about CloudTrail, see the [AWS CloudTrail User Guide](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). ## Amazon Chime information in CloudTrail CloudTrail is enabled on your AWS account when you create the account. When API calls are made from the Amazon Chime administration console, that activity is recorded in a CloudTrail event along with other AWS service events in **Event history**. You can view, search, and download recent events in your AWS account. For more information, see [Viewing events with CloudTrail event history](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). For an ongoing record of events in your AWS account, including events for Amazon Chime, create a trail. A trail enables CloudTrail to deliver log files to an Amazon S3 bucket. By default, when you create a trail in the console, the trail applies to all Regions. The trail logs events from all Regions in the AWS partition and delivers the log files to the Amazon S3 bucket that you specify. Additionally, you can configure other AWS services to further analyze and act upon the : Event data collected in CloudTrail logs. For more information, see: + [Overview for creating a trail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail supported services and integrations](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Configuring Amazon SNS notifications for CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [Receiving CloudTrail log files from multiple Regions](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) and [Receiving CloudTrail log files from multiple accounts](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) All Amazon Chime actions are logged by CloudTrail and are documented in the [https://docs.aws.amazon.com/chime/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/chime/latest/APIReference/Welcome.html). For example, calls to the `CreateAccount`, `InviteUsers` and `ResetPersonalPIN` sections generate entries in the CloudTrail log files. Every event or log entry contains information about who generated the request. The identity information helps you determine the following: + Whether the request was made with root or IAM user credentials. + Whether the request was made with temporary security credentials for a role, or a federated user. + Whether the request was made by another AWS service. For more information, see the [CloudTrail userIdentity element](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). ## Understanding Amazon Chime log file entries A trail is a configuration that enables delivery of events as log files to an Amazon S3 bucket that you specify. CloudTrail log files contain one or more log entries. An event represents a single request from any source and includes information about the requested action, the date and time of the action, request parameters, and so on. CloudTrail log files are not an ordered stack trace of the public API calls, so they do not appear in any specific order. Entries for Amazon Chime are identified by the **chime.amazonaws.com** event source. If you have configured Active Directory for your Amazon Chime account, see [Logging AWS Directory Service API calls using CloudTrail](https://docs.aws.amazon.com/directoryservice/latest/devguide/cloudtrail_logging.html). This describes how to monitor for issues that might affect your Amazon Chime users’ ability to sign in. The following example shows a CloudTrail log entry for 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" } ```