Common FAQ
Initial Validation
Section titled “Initial Validation”What is a safe first-run sequence?
Section titled “What is a safe first-run sequence?”- Run
ms-teams-agent validate --config ./config.yaml. - Run
ms-teams-agent test-connection --config ./config.yaml. - Run one cycle with
--ignore-state. - Verify ingestion in backend.
- Enable or restart service mode.
Use Collector Troubleshooting if any step fails.
What should I verify first when data is missing?
Section titled “What should I verify first when data is missing?”- Microsoft authentication and admin consent.
- Outbound connectivity to Microsoft and backend endpoints.
- At least one enabled output.
- Backend-side checks (Grail/OpenPipeline or HEC/index).
Continue with Dynatrace Troubleshooting or Splunk Troubleshooting after collector checks are green.
Network and Capacity
Section titled “Network and Capacity”Which ports should be opened?
Section titled “Which ports should be opened?”The docs define required outbound hosts and HTTPS connectivity, but no universal port matrix is valid for all enterprise proxies and backends. Validate endpoint and port requirements against your security policy.
What are the minimum CPU and memory requirements?
Section titled “What are the minimum CPU and memory requirements?”No single baseline is published because usage varies by tenant call volume and enabled features. Start with standard VM sizing and monitor MSTeams_CollectionHealth plus host metrics.
Optional Features
Section titled “Optional Features”Can I enable Auto Attendant and Call Queue collection?
Section titled “Can I enable Auto Attendant and Call Queue collection?”Yes. Enable autoattendant_collection and callqueue_collection in configuration. Review prerequisites first: Configuration and Azure Permissions.