Setup
- Go to Workspace Settings -> Integrations in the TraceRoot dashboard and Connect GitHub App.
- Grant access to the repositories you want to connect
Permissions
| Permission | Access | Why |
|---|---|---|
| Metadata | Read-only | List repositories, collaborators, and access repository metadata (mandatory) |
| Contents | Read and write | Clone and read source code for debugging; create fix PRs |
| Pull requests | Read and write | Create fix PRs from root cause analysis; read PR context |
| Issues | Read and write | Create and manage issues; read issue context for debugging |
| Commit statuses | Read-only | Read commit statuses for trace correlation |
| Discussions | Read-only | Read discussions and related context |
Requirements
For source code correlation to work:- The TraceRoot GitHub App must have access to the repository
- Traces must include git context typically auto-detected by the SDK
Git context is captured automatically for every span when you use the
@observe decorator. See Git Context.