Integration guides hub — Datadog, PagerDuty, Slack, Jira, ServiceNow

[JBAhire]

Summary

Create integration guides showing how to connect g0 with popular enterprise tools for alerting, ticketing, observability, and incident management.

Motivation

Enterprise security teams need g0 findings to flow into their existing workflows. Currently, g0 outputs JSON/SARIF/HTML but doesn't document how to pipe results into the tools teams already use. Integration guides reduce adoption friction and show g0 fitting into the enterprise toolchain.

Proposed Guides

1. Slack Notifications (docs/integrations/slack.md)

• Send scan summaries to a Slack channel via webhook
• Alert on new critical/high findings
• Daily/weekly posture summary messages
• Example: g0 scan . --json | g0-slack-notify

2. Jira / Linear Issue Creation (docs/integrations/jira.md)

• Create Jira issues for critical/high findings
• Map g0 severities to Jira priorities
• Deduplicate: don't create duplicate issues for existing findings
• Example workflow with jq + Jira REST API

3. Datadog / Grafana Metrics (docs/integrations/datadog.md)

• Push scan scores as custom metrics
• Dashboard template for agent security posture
• Alert on score degradation
• Integration with Prometheus endpoint (issue Prometheus metrics endpoint for daemon #82)

4. PagerDuty Alerts (docs/integrations/pagerduty.md)

• Trigger incidents for critical findings in CI
• Severity mapping: g0 CRITICAL → PagerDuty P1
• Auto-resolve when findings are fixed

5. ServiceNow (docs/integrations/servicenow.md)

• Create security incidents from scan findings
• Map to ServiceNow CMDB for agent inventory
• Compliance evidence upload

6. Webhook Generic (docs/integrations/webhook.md)

• Generic webhook integration pattern
• JSON payload format
• Authentication (HMAC, bearer token)
• Retry and error handling

Each Guide Includes

• Step-by-step setup instructions
• Code snippets (bash, Python, or Node.js)
• Example JSON payloads
• Recommended alerting thresholds
• CI/CD integration patterns

Files to Create

• docs/integrations/README.md — integration hub index
• docs/integrations/slack.md
• docs/integrations/jira.md
• docs/integrations/datadog.md
• docs/integrations/pagerduty.md
• docs/integrations/servicenow.md
• docs/integrations/webhook.md
• Update docs/README.md to link to integrations hub

Acceptance Criteria

• 6 integration guides with working code examples
• Each guide tested with real API endpoints
• Linked from docs index
• Generic webhook pattern for custom integrations