---
title: Twilio
description: >-
  Monitor performance issues, reduce costs, and identify security threats across
  all your Twilio resources.
breadcrumbs: Docs > Integrations > Twilio
---

# Twilio
Integration version1.0.0
## Overview{% #overview %}

Datadog's Twilio integration collects a wide variety of logs to analyze performance issues and detect threats across all your Twilio resources. Use the out-of-the-box dashboard to aggregate alerts, troubleshoot messages and call errors, and collect comprehensive event-logging and change-tracking info for your Twilio account.

By default, this integration collects [Alert Resource](https://www.twilio.com/docs/usage/monitor-alert) logs. These logs provide details for errors or warnings encountered when Twilio makes a webhook request to your server, or when your application makes a request to the REST API.

{% alert level="info" %}
You can use Cloud Cost Management to gain insight into your Twilio cost data. See the [SaaS cost integrations page](https://docs.datadoghq.com/cloud_cost_management/setup/saas_costs.md?tab=twilio) for more information.
{% /alert %}

### Message Logs{% #message-logs %}

A [Message](https://www.twilio.com/docs/messaging/api/message-resource) resource log represents an inbound or outbound message. A log will be generated when any of the following occur:

- You create a Message resource (i.e., send an outbound message) via the REST API
- Twilio executes a TwiML instruction
- Someone sends a message to one of your Twilio numbers or messaging channel addresses

Use these logs to track total delivery and troubleshoot message errors. Message bodies are never collected by Datadog.

### Call Summary Logs{% #call-summary-logs %}

[Call Summary Resource](https://www.twilio.com/docs/voice/voice-insights/api/call/call-summary-resource) logs provide an overview of metadata and performance of all calls made from your Twilio account. To get actionable insights into your calls, enable Twilio's [Voice Insights Advanced Features](https://www.twilio.com/docs/voice/voice-insights/advanced-features) for your account.

### Event Logs:{% #event-logs %}

Monitor Twilio Event Resources for comprehensive event logging and change tracking for Twilio resources. Events are logged when you provision a phone number, change your account's security settings, delete a recording, and so on. Events record virtually every action taken within Twilio, regardless of whether that action was taken through the API, by a user in the Twilio Console, or even by a Twilio employee.

Datadog [Cloud SIEM](https://app.datadoghq.com/security/home) analyzes and correlates Twilio Event logs to detect threats to your environment in real time.

## Setup{% #setup %}

### Installation{% #installation %}

1. [Generate an API key and API secret](https://www.twilio.com/docs/iam/api-keys#create-an-api-key) through the Twilio UI.
1. Find your **Account SID** on the Twilio Console dashboard, under Account Info.
1. Enter the **API key**, **API secret**, and the **account SID** of the Twilio account you want to ingest data from.
   - **Note:** In order to receive call summary data, you must enable [Voice Insights Advanced Features](https://www.twilio.com/docs/voice/voice-insights/advanced-features) for your Twilio account.
1. If you use Cloud Cost Management and enable collecting cost data, it will be visible in [Cloud Cost Management](https://app.datadoghq.com/cost) within 24 hours (see [collected data](https://docs.datadoghq.com/cloud_cost_management/setup/saas_costs.md?tab=twilio#data-collected)).

### Validation{% #validation %}

Search your Datadog logs with `source:twilio`. If you installed the integration correctly, you should see Twilio events.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

The Twilio integration does not include any metrics.

### Service Checks{% #service-checks %}

The Twilio integration does not include any service checks.

### Events{% #events %}

The Twilio integration ingests [event resources](https://www.twilio.com/docs/usage/monitor-events).

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).

## Further Reading{% #further-reading %}

- [Monitor your Twilio resources with Datadog](https://www.datadoghq.com/blog/monitor-twilio-with-datadog/)
- [Twilio](https://docs.datadoghq.com/integrations/twilio.md)