---
title: Obsidian Security
description: Gain insights into Obsidian Security Platform alerts, events and audit logs.
breadcrumbs: Docs > Integrations > Obsidian Security
---

# Obsidian Security
Integration version1.0.0            Obsidian Security - OverviewObsidian Security - Alert InsightsObsidian Security - Alert InsightsObsidian Security - Alert InsightsObsidian Security - Alert InsightsObsidian Security - Event InsightsObsidian Security - Audit InsightsObsidian Security - Audit Insights
## Overview{% #overview %}

[Obsidian Security](https://www.obsidiansecurity.com/) is a SaaS security platform that unifies visibility, governance, compliance, and threat defense for critical business applications. It helps organizations protect sensitive data, minimize risk, and streamline management across their SaaS environment.

This integration ingests the following logs:

- **Audit Logs**: Audit logs provide detailed records of user and administrative activities within the Obsidian platform for transparency, compliance, and investigation.
- **Alerts**: Alerts logs highlight risks and threats identified by Obsidian Security using machine learning, expert rules, and other detection methods.
- **Events**: Event logs capture activities occurring within cloud services, showing which actors performed actions and which targets were affected.

Integrate Obsidian Security with Datadog to gain insights into audit, alerts, and event logs 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 %}

### Generate API Token from the Obsidian Security{% #generate-api-token-from-the-obsidian-security %}

1. Log into Obsidian Security using admin account and navigate to **Settings** > **API access tokens**.
1. Click **Create token** and provide the following details:
   - Token name: A name that can help you identify the token.
   - Expiry date: Choose **Forever**.
   - **Token access** > **Role**: Choose **API**.
   - Service access: Enable **Full data access to all services and tenants**.
1. Click **Submit**.
1. Copy the Token.
1. Identify your Obsidian Security region by checking the hostname suffix of your URL:
   - \*.obsec.eu -> Europe
   - \*.sy.obsec.io -> Australia
   - \*.obsec.io -> America

### Connect your Obsidian Security Account to Datadog{% #connect-your-obsidian-security-account-to-datadog %}

1. Add your `Region` and `API Token`.
| Parameters     | Description                                                                     |
| -------------- | ------------------------------------------------------------------------------- |
| Region         | The Region of your Obsidian Security                                            |
| API Token      | The API Token of your Obsidian Security                                         |
| Get Events     | Control the collection of Events from Obsidian Security.Enabled by default.     |
| Get Alerts     | Control the collection of Alerts from Obsidian Security.Enabled by default.     |
| Get Audit Logs | Control the collection of Audit Logs from Obsidian Security.Enabled by default. |
1. Click the Save button to save your settings.

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

### Logs{% #logs %}

Obsidian Security collects and forwards audit, alert and event logs to Datadog.

### Metrics{% #metrics %}

Obsidian Security does not include any metrics.

### Events{% #events %}

Obsidian Security does not include any events.

## Troubleshooting{% #troubleshooting %}

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