メニュー
Structured triage workflow for CarbonJ bugs — reproduce, isolate to a pipeline phase (ingest / accumulate / store / query), then write a failing test before patching.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | debug |
| description | Structured triage workflow for CarbonJ bugs — reproduce, isolate to a pipeline phase (ingest / accumulate / store / query), then write a failing test before patching. |
cfgKinesis / cfgAccumulator overrides in effect.CarbonJ is ingest → accumulate → store → query. Identify which phase failed:
| Symptom | Likely phase | Where to look |
|---|---|---|
| Points dropped at the edge, line-protocol parse errors | ingest | engine/LineProtocolHandler, engine/PickleProtocolHandler, netty/, InputQueue, PointProcessor* |
| Kinesis lag, checkpoint stuck, KCL warnings | ingest (Kinesis) | engine/KinesisConsumer, KinesisRecordProcessor, cfgKinesis, FileCheckPointMgr, DynamoDbCheckPointMgr |
| Wrong rollup values, missing aggregated series | accumulate | accumulator/AccumulatorImpl, MetricAggregationRule, aggregation-rules-test.conf, recovery/ |
| Glob queries return nothing / wrong ids | store/index | db/index/MetricIndexImpl, IndexStoreRocksDB, QueryUtils, QueryPart |
| Data missing in 5m or 30m archive | store/points | db/points/DataPointArchiveRocksDB, IntervalProcessor*, StagingFile* |
| HTTP 500 / wrong JSON shape | query | engine/Graphite*Servlet, admin/ |
| Wrong routing between shards | relay | Relay, RelayRouter, RelayRules, relay-rules.conf, blacklist.conf |
cfg* classThe bean wiring for the phase is in the corresponding @Configuration class. Tunables almost always live there, not at the use site.
Add a JUnit 5 test in the matching package under carbonj.service/src/test/java/.... Reuse fixtures from carbonj.service/src/test/resources/ (e.g. aggregation-rules-test.conf).
Run scoped:
./gradlew :carbonj.service:test --tests <FQCN>.<method> --info
./gradlew :carbonj.service:test../gradlew licenseMain.60s24h, 5m7d, 30m2y — admin APIs depend on them.kinesis/, you need it running locally.master; debug commits should land on a feature branch.Verify and auto-fix the BSD-3-Clause license headers that the build enforces. CarbonJ has no checkstyle/spotless — license headers are the only enforced static check.
Self-review checklist for a CarbonJ change before opening or merging a PR. Aligns with what CI enforces.
Build the bootJar and start CarbonJ locally on the default `dev` profile.
Run CarbonJ tests. Defaults to the service module's full unit+integration suite. Pass an FQCN (e.g. `com.demandware.carbonj.service.db.points.SomeTest`) or pattern to scope.