ide-shepherd integration

Author: tesnim5hamdouni

.github/CODEOWNERS

@@ -761,6 +761,11 @@ plaid/assets/logs/                                                  @DataDog/saa
 /bluecat_edge/manifest.json                                           @DataDog/saas-integrations @DataDog/documentation
 /bluecat_edge/assets/logs/                                            @DataDog/saas-integrations @DataDog/documentation @DataDog/logs-integrations-reviewers
 
+/ide-shepehr/                                              @DataDog/saas-integrations @DataDog/agent-integrations
+/ide-shepherd/*.md                                                @DataDog/saas-integrations @DataDog/agent-integrations @DataDog/documentation
+/ide-shepherd/manifest.json                                       @DataDog/saas-integrations @DataDog/agent-integrations @DataDog/documentation
+/ide-shepherd/assets/logs/                                        @DataDog/saas-integrations @DataDog/documentation @DataDog/logs-integrations-reviewers
+
 # To keep Security up-to-date with changes to the signing tool.
 /datadog_checks_dev/datadog_checks/dev/tooling/signing.py             @DataDog/agent-integrations
 # As well as the secure downloader.

.github/workflows/config/labeler.yml

@@ -674,6 +674,10 @@ integration/iboss:
 - changed-files:
   - any-glob-to-any-file:
     - iboss/**/*
+integration/ide_shepherd:
+- changed-files:
+  - any-glob-to-any-file:
+    - ide_shepherd/**/*
 integration/ignite:
 - changed-files:
   - any-glob-to-any-file:

ide_shepherd/CHANGELOG.md

@@ -0,0 +1,7 @@
+# CHANGELOG - ide-shepherd
+
+## 1.0.0 / 2026-01-23
+
+***Added***:
+
+* Initial Release

ide_shepherd/README.md

@@ -0,0 +1,107 @@
+# IDE Shepherd
+
+## Overview
+
+[IDE Shepherd][1] is a real-time security monitoring and protection tool for IDE environments. It monitors extension and workspace task activities in VS Code and Cursor, actively blocking malicious behaviors to protect developer endpoints from supply chain attacks and compromised extensions. IDE Shepherd hence enables security teams to detect and respond to threats in real-time by providing observability into security and extension lifecycle events (installation, updates, and uninstallation).
+
+Integrate IDE Shepherd with Datadog's pre-built dashboard visualizations to gain insights into security alerts, extension activities, and workspace task monitoring. With Datadog's built-in log pipelines, you can parse and enrich these logs to facilitate easy search and detailed insights. The integration includes ready-to-use dashboards for monitoring security events, extension lifecycle, and activity patterns by IDE type and host.
+
+## Setup
+
+### Configuration
+
+**1. Install and Start Datadog Agent**
+
+First, ensure the Datadog Agent is installed and running on your system with your organization API key configured. See [Datadog Agent Installation Guide](https://docs.datadoghq.com/agent/) for installation instructions.
+
+**2. Install IDE Shepherd Extension**
+
+Install the IDE Shepherd extension in VS Code or Cursor from the [IDE Shepherd repository][1].
+
+**3. Enable Telemetry in IDE Shepherd**
+
+IDE Shepherd **automatically configures the Datadog Agent** when you enable telemetry for the first time:
+
+1. Open the IDE Shepherd sidebar in VS Code or Cursor
+2. Navigate to **Settings > Datadog Telemetry**
+3. Click on **Telemetry: Disabled** to enable it
+4. IDE Shepherd will automatically:
+   - Create the configuration directory: `/opt/datadog-agent/etc/conf.d/ide-shepherd.d/`
+   - Write the configuration file: `conf.yaml` with the appropriate settings
+   - Configure the agent to listen on the default port
+
+
+*We recommend keeping the default port configuration. The extension will handle all the setup automatically.*
+
+**4. Restart Datadog Agent**
+
+After the automatic configuration, IDE Shepherd will request permission to restart the Datadog Agent. If it fails, you can restart it manually with the following commands:
+
+```bash
+# Linux
+sudo systemctl restart datadog-agent
+
+# macOS
+launchctl stop com.datadoghq.agent
+launchctl start com.datadoghq.agent
+```
+
+See [Datadog Agent Commands][2] for more details.
+
+**5. Verify Telemetry Status**
+
+Telemetry is now **sent automatically** in real-time:
+
+- Extension installed/updated/uninstalled -> OCSF event sent immediately
+- Security threat detected -> OCSF event sent immediately
+
+You can verify the connection from the IDE Shepherd sidebar:
+
+- **Agent Status**: Shows if the Datadog Agent is up and running
+- **Agent Port**: Shows the port on which the agent is listening
+
+### Validation
+
+[Run the Agent's status subcommand][2] and look for `ide-shepherd` under the Logs Agent section. You can also verify in the IDE Shepherd sidebar that the **Agent Status** shows as connected.
+
+To view your logs in Datadog:
+
+1. Go to the [Datadog Logs Explorer](https://app.datadoghq.com/logs)
+2. Filter by: `source:ide-shepherd service:ide-shepherd-telemetry`
+3. Explore security events, extension lifecycle events, and workspace task activities
+
+## Data Collected
+
+### Logs
+
+The IDE Shepherd integration collects and forwards IDE security and activity logs to Datadog, including:
+
+- **Security Events**: Real-time alerts for malicious extension activities and blocked threats
+- **Extension Lifecycle Events**: Installation, update, and uninstallation events
+- **Extension Metadata**: Name, version, publisher information along with a risk estimate based on hardcoded heuristics.
+- **OCSF (Open Cybersecurity Schema Framework) classified events**: Standardized security event formats
+
+The logs are automatically enriched with:
+- OCSF class UIDs (Application Security Posture Finding, Detection Finding)
+- IDE type (VS Code, Cursor) and its version
+- Host information
+- Security technique information for flagged behaviors
+- Observable threat indicators
+
+### Metrics
+
+The IDE Shepherd integration does not include any metrics.
+
+### Events
+
+The IDE Shepherd integration does not include any events.
+
+## Troubleshooting
+
+Need help? Contact [Datadog support][4].
+
+[1]: https://github.com/DataDog/IDE-SHEPHERD-extension
+[2]: https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information
+[3]: https://docs.datadoghq.com/getting_started/site/#access-the-datadog-site
+[4]: https://docs.datadoghq.com/help/
+[5]: https://docs.datadoghq.com/agent/guide/agent-configuration-files/#agent-configuration-directory