Protection Analytics
When your project is linked to the cloud, shield automatically reports protection events to your dashboard.
Viewing Analytics
- Go to app.dotsetlabs.com
- Select your project
- View the Overview tab
Available Metrics
| Metric | Description |
|---|
| Total Runs | Number of dotset run executions |
| Exposures Blocked | Secrets caught before they leaked |
| Protection Rate | Percentage of runs without exposures |
| Top Exposed Secrets | Most frequently blocked secret keys |
Event Details
Each protection event includes:
{
"command": "npm start",
"mode": "redact",
"secretCount": 12,
"exposureCount": 2,
"exposures": [
{ "patternName": "DATABASE_URL", "count": 1 },
{ "patternName": "API_KEY", "count": 1 }
],
"duration": 4500,
"exitCode": 0
}
Privacy: Secret values are never transmitted. Only key names and counts.
Retention by Plan
| Plan | Analytics Retention |
|---|
| Free | 7 days |
| Pro | 90 days |
| Business | 1 year |
Linking Your Project
# Get token from dashboard
dotset link <project-id> --token <token>
# Verify
dotset status
Disabling Telemetry
For individual runs:
dotset run --no-telemetry -- npm start
