---
title: Vectra
description: Gain insights into Vectra detections, entity scoring events and audit events
breadcrumbs: Docs > Integrations > Vectra
---

# Vectra
Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}
            Vectra OverviewVectra OverviewVectra Detection InsightsVectra Detection InsightsVectra Entity Score Change InsightsVectra Entity Score Change InsightsVectra Audit InsightsVectra Audit Insights
## Overview{% #overview %}

[Vectra](https://www.vectra.ai/) provides a platform for detecting, investigating, and responding to advanced threats across hybrid environments.

This integration ingests the following logs:

- **Detections**: Detections provide detailed information about security events detected within the Vectra platform, with events generated upon the initial detection and each subsequent update.
- **Entity Scoring Events**: Entity Scoring Events provide detailed information on changes to an entity's score, which occur upon initial threat detection, the discovery of additional detections, and updates to any previously discovered detections.
- **Audit Events**: Audit Events provide detailed information on user actions performed within the system.

Integrate Vectra with Datadog to gain insights into detections, entity scoring events and audit events using pre-built dashboard visualizations. Datadog uses its built-in log pipelines to parse and enrich these logs, facilitating easy search and detailed insights. Additionally, the integration can be used with Cloud SIEM detection rules for enhanced monitoring and security.

## Setup{% #setup %}

### Obtaining Client Credentials{% #obtaining-client-credentials %}

1. Log in to Vectra Platform and navigate to **Configuration** > **Access** > **API Clients**.
1. Click **Add API Client** and configure the following parameters:
   - Client Name: A user-friendly name to identify the client
   - Role: Choose **Auditor**
1. Click **Generate Credentials** and copy the Client ID and Secret Key for later use.
1. Identify your Sub Domain by checking the hostname suffix of your Vectra Platform URL. For example, if `<example>.portal.vectra.ai` is your platform URL, then `example` is your Sub Domain.

### Connect your Vectra Account to Datadog{% #connect-your-vectra-account-to-datadog %}

1. Add your `Sub Domain`, `Client ID` and `Secret Key`.
| Parameters                | Description                                                                      |
| ------------------------- | -------------------------------------------------------------------------------- |
| Sub Domain                | The Sub Domain from Vectra Platform URL                                          |
| Client ID                 | The Client ID of your Vectra Platform                                            |
| Secret Key                | The Secret Key of your Vectra Platform                                           |
| Get Detections            | Controls the collection of Detections from Vectra.Enabled by default.            |
| Get Entity Scoring Events | Controls the collection of Entity Scoring Events from Vectra.Enabled by default. |
| Get Audit Events          | Controls the collection of Audit Events from Vectra.Enabled by default.          |
1. Click **Save**.

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

### Logs{% #logs %}

Vectra collects and forwards detections, entity scoring events, and audit events to Datadog.

### Metrics{% #metrics %}

Vectra does not include any metrics.

### Events{% #events %}

Vectra does not include any events.

## Troubleshooting{% #troubleshooting %}

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