LoggingServiceV2Client loses automatic WriteLogEntries batching after the logging-api split
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 1-2 ngày
- Mức phù hợp với người mới
- 54/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- google-cloud, node.js, typescript
Hướng nghiên cứu
Start by reading the logging-api onboarding change in PR #8863 and the package split in PR #8929, then inspect the LoggingServiceV2Client generation configuration and historical logging_gapic.yaml linked in the issue. Confirm where bundling defaults and the WriteLogEntries batching descriptor are configured. Done means compatible separate writes are coalesced into one transport request in v12, with a regression test covering that behavior.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Please make sure you have searched for information in the following guides.
- Search the issues already opened: https://github.com/GoogleCloudPlatform/google-cloud-node/issues
- Search StackOverflow: http://stackoverflow.com/questions/tagged/google-cloud-platform+node.js
- Check our Troubleshooting guide: https://github.com/googleapis/google-cloud-node/blob/main/docs/troubleshooting.md
- Check our FAQ: https://github.com/googleapis/google-cloud-node/blob/main/docs/faq.md
- Check our libraries HOW-TO: https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md
- Check out our authentication guide: https://github.com/googleapis/google-auth-library-nodejs
- Check out handwritten samples for many of our APIs: https://github.com/GoogleCloudPlatform/nodejs-docs-samples
- Check the API's issue tracker: https://cloud.google.com/support/docs/issue-trackers
Library Name
@google-cloud/logging — comparing 11.2.1 and 12.0.0
A screenshot that you have tested with "Try this API".
Not applicable: this issue concerns client-side request batching in the generated Node.js SDK. API Explorer sends requests directly and cannot exercise the SDK's google-gax batching scheduler.
The linked reproduction uses mocked transport calls and exercises the actual generated client wrappers and google-gax scheduler. It requires no credentials or Google Cloud project and makes no real Google Cloud API calls.
No API Explorer test was performed.
Link to the code that reproduces this issue. A link to a public Github Repository or gist with a minimal reproduction.
https://github.com/jacekerd/google-logging-batching-repro
A step-by-step description of how to reproduce the issue, based on the linked reproduction.
Requirements: Node.js 22 or newer and npm.
-
Clone the reproduction:
git clone https://github.com/jacekerd/google-logging-batching-repro.git cd google-logging-batching-repro -
Install the two locked dependency trees:
npm ci --prefix versions/v11 --ignore-scripts --no-audit --no-fund npm ci --prefix versions/v12 --ignore-scripts --no-audit --no-fund -
Inspect batching metadata and exercise compatible writes:
npm run check:v11 npm run check:v12 npm run behavior npm test -
Run the assertion that v12 should preserve v11 batching behavior:
npm run test:expect-v11
Observed results:
- v11.2.1 has descriptors.batching.writeLogEntries; two compatible writes produce one mocked transport invocation containing both entries.
- v12.0.0 has an empty descriptors.batching object; the same writes produce two separate mocked transport invocations.
- npm test passes five tests documenting these observations.
- npm run test:expect-v11 intentionally exits 1, with one failed parity assertion.
The reproduction uses real generated wrappers and google-gax scheduling, with the transport stubbed. No credentials or real Cloud API requests are required.
A clear and concise description of what the bug is, and what you expected to happen.
Automatic WriteLogEntries batching differs between @google-cloud/[email protected] and @google-cloud/[email protected].
In 11.2.1, LoggingServiceV2Client initializes descriptors.batching.writeLogEntries and combines compatible calls into one transport request.
In 12.0.0, LoggingServiceV2Client is re-exported from @google-cloud/[email protected]. That generated implementation has an empty batching descriptor object and lacks the corresponding bundling defaults and batching descriptor selection.
Expected: compatible WriteLogEntries calls retain automatic batching.
Actual: two compatible calls produce two transport requests instead of one.
Explicit higher-level log.write([entry1, entry2]) remains supported. The issue concerns automatic coalescing across separate GAPIC calls.
These versions establish the behavioral difference; they do not identify the first affected intermediate release.
A clear and concise description WHY you expect this behavior, i.e., was it a recent change, there is documentation that points to this behavior, etc. **
@google-cloud/[email protected] automatically combines compatible WriteLogEntries calls. I expected this behavior to remain available after upgrading to 12.0.0.
The historical Node.js generation target explicitly supplied google/logging/v2/logging_gapic.yaml, which defines batching for WriteLogEntries. Investigation indicates that the logging-api onboarding omitted nodejs.bundle_config from librarian.yaml, causing the generated client to lose its batching descriptor, bundling defaults, and batching descriptor selection.
The reproduction demonstrates one mocked transport invocation for two compatible writes in v11, versus two invocations in v12. Restoring the missing configuration in memory restores batching with v12's existing google-gax runtime.
Relevant references:
- Reproduction: https://github.com/jacekerd/google-logging-batching-repro
- Historical batching configuration: https://github.com/googleapis/googleapis/blob/2b625c91510a2e8320a778bc88af8b65bc4a19a2/google/logging/v2/logging_gapic.yaml
- logging-api onboarding: https://github.com/googleapis/google-cloud-node/pull/8863
- Logging package split: https://github.com/googleapis/google-cloud-node/pull/8929
I'd expect the automatic GAPIC batching to be preserved across this migration.
- Ngôn ngữ chính
- TypeScript
- Star
- 3.2k
- Fork
- 732
- Merge trung bình
- 2 ngày 11 giờ
- Pull request đã merge (30 ngày)
- 99
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của googleapis/google-cloud-node
-
Broken deprecation chainĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 66/100
googleapis/google-cloud-node#9854 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
pubsub: "Operation attempted on ended Span" when a modack is flushed after the message was ackedĐang mởapi: pubsub
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
googleapis/google-cloud-node#9853 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
storage: V4 getSignedUrl sorts canonical headers with localeCompare, so they disagree with X-Goog-SignedHeadersCó thể đã có người làm @itsrayeedscodespace đã nhận 9 ngày trước. Đang mởapi: storage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
googleapis/google-cloud-node#9840 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
firestore: getPartitions() emits gax AutopaginateTrueWarning in every processCó thể đã có người làm @TheRealDanii đã nhận 12 ngày trước. Đang mởapi: firestore
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
googleapis/google-cloud-node#9736 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 82/100
googleapis/google-cloud-node#9723 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của googleapis/google-cloud-node
Issue tương tự
-
Type/Improvement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 67/100
OpenNSW/nsw-srilanka#1259 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
oxc-project/tsrs#1010 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Fission-AI/OpenSpec#2260 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Add: ESP 1 UKĐang mởcheck:passed streams:add
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 64/100
Maintainer thường phản hồi trong vòng 1 ngày
-
area:infra area:storage bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
THU-MAIC/OpenMAIC#2311 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày