Skip to content

Commit 0a9543e

Browse files
authored
Add instructions for bisecting upstream regressions (microsoft#4509)
1 parent 9cb3dcf commit 0a9543e

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

.github/copilot-instructions.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -134,3 +134,24 @@ throw new FriendlyException(
134134
- Use `hideFromDependabot()` for test-only dependencies
135135
- Smoke tests validate end-to-end functionality in realistic environments
136136
- Check `gradle.lockfile` when dependency issues arise
137+
138+
## How to bisect an upstream OpenTelemetry Agent regression
139+
140+
To identify which upstream commit introduced a regression:
141+
142+
1. Update `dependencyManagement/build.gradle.kts` to use SNAPSHOT version (e.g., `2.10.0-alpha-SNAPSHOT`)
143+
2. Clone and bisect the upstream repo:
144+
```bash
145+
git clone https://github.com/open-telemetry/opentelemetry-java-instrumentation.git
146+
cd opentelemetry-java-instrumentation
147+
git bisect start v2.10.0 v2.9.0
148+
```
149+
3. For each bisect iteration:
150+
```bash
151+
./gradlew publishToMavenLocal
152+
cd /path/to/ApplicationInsights-Java
153+
./gradlew :smoke-tests:apps:YourApp:smokeTest --tests "*YourFailingTest"
154+
cd /path/to/opentelemetry-java-instrumentation
155+
git bisect good # or bad
156+
```
157+
4. When done: `git bisect reset` and restore `dependencyManagement/build.gradle.kts`

0 commit comments

Comments
 (0)