groundcover-github-action/action.yml at 2e05e1193d3c169558053f4bc0e92640556a8db8 · groundcover-com/groundcover-github-action · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
name: "groundcover OTEL CI/CD Export"
description: "Export GitHub Actions workflow runs as OpenTelemetry traces to groundcover"
author: "groundcover"

inputs:
  groundcoverEndpoint:
    description: >
      groundcover OTLP endpoint base URL. Supports https://, http://, and grpc:// schemes.
      Do not include /v1/traces — the exporter appends it automatically.
    required: true
  otlpHeaders:
    description: >
      Advanced. Comma-separated key=value pairs for OTLP exporter headers.
      Takes precedence over `apiKey` when both are set.
    required: false
  apiKey:
    description: >
      groundcover ingestion key.
    required: false
  githubToken:
    description: >
      GitHub token with actions:read permission. Required for private repos.
      Use secrets.GITHUB_TOKEN or a PAT.
    required: false
  runId:
    description: "Workflow Run ID to export. Defaults to the current workflow run."
    required: false
  otelServiceName:
    description: "Override the OTEL service.name resource attribute. Defaults to the workflow name."
    required: false
  traceparent:
    description: >
      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.
    required: false
  env:
    description: "Environment name (e.g., production, staging). Added as a resource attribute."
    required: false
  workload:
    description: "Workload name. Defaults to the workflow name."
    required: false
  extraAttributes:
    description: >
      Extra resource attributes as comma-separated key=value pairs.
      Example: "team=platform,region=us-east-1"
    required: false
  testResultsGlob:
    description: >
      Optional comma-separated glob patterns for JUnit XML test result files.
      Matching files are parsed and summarized onto the workflow root span.
    required: false
  exportLogs:
    description: >
      Optional. When set to true, download GitHub Actions job logs and attach them to exported job spans.
      Log content is truncated before export.
    required: false
  groundcoverBaseUrl:
    description: >
      Base URL for your groundcover web app, used in PR comments that link to traces.
      Defaults to https://app.groundcover.com.
    required: false
    default: "https://app.groundcover.com"
  commentOnPr:
    description: >
      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.
    required: false
    default: "true"
  groundcoverDuration:
    description: >
      Duration window for the PR comment traces link. Defaults to "Last 6 hours".
    required: false
    default: "Last 6 hours"
  groundcoverBackendId:
    description: >
      Optional backendId query parameter for the PR comment traces link.
    required: false
  groundcoverTenantUUID:
    description: >
      Optional tenantUUID query parameter for the PR comment traces link.
    required: false

outputs:
  traceId:
    description: "The OpenTelemetry Trace ID of the exported trace"

branding:
  icon: "activity"
  color: "green"

runs:
  using: "node24"
  main: "dist/index.js"