Chimesdk Diagnostics

Chime SDK Diagnostics

When to use

Any Amazon Chime SDK investigation — meeting creation, audio/video, messaging, SIP media, PSTN, identity, or SDK integration issues.

Investigation workflow

Step 1 — Collect and triage

aws chime-sdk-meetings list-attendees --meeting-id <meeting-id>
aws chime-sdk-voice list-sip-media-applications --max-results 20
aws chime-sdk-messaging list-channels --app-instance-arn <app-instance-arn>
aws cloudwatch get-metric-statistics --namespace AWS/ChimeSDK --metric-name MeetingCount --start-time <start> --end-time <end> --period 3600 --statistics Sum

Step 2 — Domain deep dive

aws chime-sdk-meetings get-meeting --meeting-id <meeting-id>
aws chime-sdk-voice get-sip-media-application --sip-media-application-id <id>
aws chime-sdk-identity list-app-instances --max-results 20
aws chime-sdk-messaging describe-channel --channel-arn <channel-arn> --app-instance-user-arn <user-arn>

Step 3 — Detailed investigation

aws cloudtrail lookup-events --lookup-attributes AttributeKey=EventSource,AttributeValue=chime.amazonaws.com --max-results 10
aws chime-sdk-voice list-phone-numbers --max-results 20
aws chime-sdk-voice get-voice-connector --voice-connector-id <id>

Read references/guardrails.md before concluding on any Chime SDK issue.

Gotchas: Chime SDK

• Chime SDK has separate services: Meetings, Messaging, Voice, Identity, Media Pipelines.
• Meeting attendee tokens are sensitive — generate server-side, pass to client.
• SIP media applications require Lambda functions for call control.
• PSTN audio requires phone number provisioning and SIP rules.
• Messaging uses app instances and app instance users for identity.
• Media regions affect latency — choose closest to participants.
• WebRTC is used for meetings — requires UDP connectivity.

Anti-hallucination rules

1. Chime SDK Meetings, Messaging, and Voice are separate services with different APIs.
2. Meeting IDs and attendee tokens are ephemeral — meetings expire after inactivity.
3. SIP media applications require Lambda for call flow logic.
4. Phone numbers must be provisioned before use in PSTN audio.
5. App instance users are required for messaging — they're not IAM users.
6. Spend no more than 2 minutes on any single hypothesis. Pivot if inconclusive.

14 runbooks