Binary log config: `-service/*` exclusion is accepted and silently turned into a per-service rule, so the service is still logged
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 82/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- java
- Domain
- observability
Research direction
The config parsing lives in FactoryImpl in services/src/main/java/io/grpc/protobuf/services/BinlogHelper.java (around lines 645-669), and isServiceGlob is near lines 781-783. Start by adding the reported test to BinlogHelperTest and running it to see the first config that is wrongly accepted. Done means *,-p.s/*, -p.s/*, -* and -p.s/m{h} throw Illegal log config pattern, and the existing BinlogHelperTest cases still pass.
Written by the indexing model from the issue text.
Description
What version of gRPC-Java are you using?
master at 15d64a4 (1.86.0-SNAPSHOT); the parsing code is unchanged on current master.
What is your environment?
Linux x86_64, OpenJDK 21.0.2, Gradle 8.14.5 (wrapper).
What did you expect to see?
A binary log config (from GRPC_BINARY_LOG_CONFIG or BinaryLogs.createBinaryLog(sink, configStr)) that contains an exclusion with a wildcard (-p.s/*) or with a {h|m} suffix (-p.s/m{h}) is rejected with IllegalArgumentException("Illegal log config pattern: ..."), like other malformed patterns. gRFC A16 says:
If the pattern is
-<service>/<method>, then the specified method must not be logged. The "*" wildcard must not be used for negations, i.e.-<service>/*is not supported.
...
If a pattern is malformed, the gRPC process must refuse to start up
and its grammar defines Excluded-Method -> "-" Full-Method-Name, with no Pattern-Config suffix.
What did you see instead?
Both configs are accepted.
Location (grpc/grpc-java @ 15d64a4):
services/src/main/java/io/grpc/protobuf/services/BinlogHelper.java:645-669:FactoryImplchecksisServiceGlob()beforestartsWith("-"), and the exclusion branch ignoresbinlogOptionStr.services/src/main/java/io/grpc/protobuf/services/BinlogHelper.java:781-783:isServiceGlobonly checksendsWith("/*").
} else if (isServiceGlob(methodOrSvc)) {
// parse config for a service, e.g. "service/*"
String service = MethodDescriptor.extractFullServiceName(methodOrSvc);
...
perServiceLogs.put(service, createBinaryLog(sink, binlogOptionStr));
...
} else if (methodOrSvc.startsWith("-")) {
// parse config for a method, e.g. "-service/method"
String blacklistedMethod = methodOrSvc.substring(1);
...
blacklistedMethods.add(blacklistedMethod);
Problem
-p.s/*ends with/*, so it takes the service-glob branch and registers a per-service log for a service literally named-p.s. No exclusion is recorded, so with*,-p.s/*every method ofp.sis still logged through the global*rule. The user asked for the service not to be logged, and its headers and messages end up in the binary log without any warning.-*is stored as an exclusion for a method literally named*, which never matches anything.-p.s/m{h}excludesp.s/mas intended, but the{h}suffix (invalid for an exclusion) is silently dropped.
Only the first case changes what gets logged. The other two are malformed configs that are accepted without an error.
Steps to reproduce the bug
Reproduction
Regression test added to BinlogHelperTest:
diff --git a/services/src/test/java/io/grpc/protobuf/services/BinlogHelperTest.java b/services/src/test/java/io/grpc/protobuf/services/BinlogHelperTest.java
--- a/services/src/test/java/io/grpc/protobuf/services/BinlogHelperTest.java
+++ b/services/src/test/java/io/grpc/protobuf/services/BinlogHelperTest.java
@@ -341,6 +341,18 @@ public final class BinlogHelperTest {
assertNotNull(makeLog("-p.s/blacklisted,p.s/*", "p.s/allowed"));
}
+ @Test
+ public void configBinLog_blacklist_wildcardOrOptionsRejected() {
+ for (String configStr : new String[] {"*,-p.s/*", "-p.s/*", "-*", "-p.s/m{h}"}) {
+ try {
+ new FactoryImpl(sink, configStr);
+ fail("Expected IllegalArgumentException for " + configStr);
+ } catch (IllegalArgumentException expected) {
+ assertThat(expected).hasMessageThat().startsWith("Illegal log config pattern");
+ }
+ }
+ }
+
private void assertDuplicatelPatternDetected(String factoryConfigStr) {
try {
new BinlogHelper.FactoryImpl(sink, factoryConfigStr);
./gradlew :grpc-services:test --tests io.grpc.protobuf.services.BinlogHelperTest -PskipCodegen=true -PskipAndroid=true
BinlogHelperTest > configBinLog_blacklist_wildcardOrOptionsRejected FAILED
java.lang.AssertionError: Expected IllegalArgumentException for *,-p.s/*
at org.junit.Assert.fail(Assert.java:89)
at io.grpc.protobuf.services.BinlogHelperTest.configBinLog_blacklist_wildcardOrOptionsRejected(BinlogHelperTest.java:349)
172 tests completed, 1 failed
Environment:
- Commit:
15d64a4678450991aa5bf7af23066d36b3391351 - Toolchain: OpenJDK 21.0.2, Gradle 8.14.5
Already fixed in grpc/grpc-go
PR: https://github.com/grpc/grpc-go/pull/2299 ("binarylog: implement env variable config parsing", merged 2018-09-26T20:03:55Z, merge commit a338994886e). grpc-go's parser for the same A16 config string handles a leading - first and rejects both a * method and a {...} suffix in exclusions.
How grpc-go fixed it (relevant hunks, verbatim):
--- a/internal/binarylog/env_config.go
+++ b/internal/binarylog/env_config.go
@@ -0,0 +1,206 @@
...
+ // "-service/method", blacklist, no * or {} allowed.
+ if config[0] == '-' {
+ s, m, suffix, err := parseMethodConfigAndSuffix(config[1:])
+ if err != nil {
+ return fmt.Errorf("invalid config: %q, %v", config, err)
+ }
+ if m == "*" {
+ return fmt.Errorf("invalid config: %q, %v", config, "* not allowd in blacklist config")
+ }
+ if suffix != "" {
+ return fmt.Errorf("invalid config: %q, %v", config, "header/message limit not allowed in blacklist config")
+ }
+ if err := l.setBlacklist(s + "/" + m); err != nil {
+ return fmt.Errorf("invalid config: %v", err)
+ }
+ return nil
+ }
...
Suggested fix
Reject an exclusion that contains * or has a {...} suffix before the pattern is classified, using the same Illegal log config pattern error as other malformed entries:
diff --git a/services/src/main/java/io/grpc/protobuf/services/BinlogHelper.java b/services/src/main/java/io/grpc/protobuf/services/BinlogHelper.java
--- a/services/src/main/java/io/grpc/protobuf/services/BinlogHelper.java
+++ b/services/src/main/java/io/grpc/protobuf/services/BinlogHelper.java
@@ -635,6 +635,11 @@ final class BinlogHelper {
if (methodOrSvc.isEmpty()) {
throw new IllegalArgumentException("Illegal log config pattern: " + configuration);
}
+ if (methodOrSvc.startsWith("-")
+ && (binlogOptionStr != null || methodOrSvc.contains("*"))) {
+ // An exclusion names exactly one method; '*' and '{...}' are not allowed
+ throw new IllegalArgumentException("Illegal log config pattern: " + configuration);
+ }
if (methodOrSvc.equals("*")) {
// parse config for "*"
checkState(
Verified on 15d64a4 (OpenJDK 21.0.2, Gradle 8.14.5): the test above fails without this patch and passes with it; no other test results change (:grpc-services:test).
I can submit a PR for this.
Checked: searches for binlog blacklist/exclusion wildcard, BinlogHelper config pattern and GRPC_BINARY_LOG_CONFIG exclusions found no existing issue or PR about this.
- Dominant language
- Java
- Stars
- 12.1k
- Forks
- 4k
- Avg merge
- 1d 13h
- Merged PRs (30d)
- 42
Getting set up
- No Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from grpc/grpc-java
-
alts: AuthorizationUtil.clientAuthorizationCheck compares the peer service account case-sensitivelyOpen
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 1 day
-
xds: EDS resource is not NACKed when locality weights at one priority sum to more than uint32 maxOpen
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
grpc/grpc-java#13150 · 1 comment ·
Maintainers usually reply within 1 day
Similar issues
-
[Bug] 资源包列表 与 模组/数据包/世界 列表排列顺序不一致Possibly taken @fishdry1000 claimed this 4 days ago. Openbug
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
AtlasOfLivingAustralia/species-lists#882 ·
Maintainers usually reply within 1 day
-
Type/Bug
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
ballerina-platform/ballerina-library#9458 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
winder/Universal-G-Code-Sender#3242 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
PCL-Community/PCL-CE#3767 ·
Maintainers usually reply within 1 day