| groundcoverEndpoint | groundcover OTLP endpoint base URL. Supports https://, http://, and grpc:// schemes. Do not include /v1/traces — the exporter appends it automatically.
| yes | — |
| otlpHeaders | Advanced. Comma-separated key=value pairs for OTLP exporter headers. Takes precedence over `apiKey` when both are set.
| no | — |
| apiKey | groundcover ingestion key.
| no | — |
| githubToken | GitHub token with actions:read permission. Required for private repos. Use secrets.GITHUB_TOKEN or a PAT.
| no | — |
| runId | Workflow Run ID to export. Defaults to the current workflow run. | no | — |
| otelServiceName | Override the OTEL service.name resource attribute. Defaults to the workflow name. | no | — |
| traceparent | W3C Trace Context traceparent header value (e.g., 00-<trace_id>-<span_id>-01). When provided, the workflow root span becomes a child of this trace context, enabling correlation between CI/CD traces and application traces. When omitted, a new root trace is created.
| no | — |
| env | Environment name (e.g., production, staging). Added as a resource attribute. | no | — |
| workload | Workload name. Defaults to the workflow name. | no | — |
| extraAttributes | Extra resource attributes as comma-separated key=value pairs. Example: "team=platform,region=us-east-1"
| no | — |
| testResultsGlob | Optional comma-separated glob patterns for JUnit XML test result files. Matching files are parsed and summarized onto the workflow root span.
| no | — |
| exportLogs | Download GitHub Actions job logs and export them as OpenTelemetry log records correlated with the matching job and step spans. Set to false to disable.
| no | true |
| groundcoverBaseUrl | Base URL for your groundcover web app, used in PR comments that link to traces. Defaults to https://app.groundcover.com.
| no | https://app.groundcover.com |
| commentOnPr | When true, upsert a single PR comment with the trace ID, a groundcover traces link pre-filtered by PR number, and the workflow run link. Requires issues: write permission.
| no | true |
| groundcoverDuration | Duration window for the PR comment traces link. Defaults to "Last 6 hours".
| no | Last 6 hours |
| groundcoverBackendId | Optional backendId query parameter for the PR comment traces link.
| no | — |
| groundcoverTenantUUID | Optional tenantUUID query parameter for the PR comment traces link.
| no | — |