docs: troubleshooting guide for logging#9315
docs: troubleshooting guide for logging#9315gcf-merge-on-green[bot] merged 2 commits intogoogleapis:mainfrom
Conversation
|
very minor nit: guilde -> guide in PR title |
| .level=INFO | ||
|
|
||
| # Specify logging level for certain packages | ||
| com.google.api.level=ALL |
There was a problem hiding this comment.
Can we add notes to indicate that this is only needed for REST APIs and io.groc.level below is only needed for gRPC APIs?
There was a problem hiding this comment.
Added comments.
Note that even when you use gRPC library, some authentication happens in HTTP 1.1.
There was a problem hiding this comment.
Note that even when you use gRPC library, some authentication happens in HTTP 1.1.
Thanks, that's good to know. I guess it would be mostly covered by the com.google.auth.level=FINE below?
There was a problem hiding this comment.
That does not show HTTP headers.
| io.grpc.level=FINE | ||
|
|
||
| # Example when we want to specify storge library's level | ||
| com.google.cloud.storage.level=INFO |
There was a problem hiding this comment.
I'm afraid this is only useful for handwritten libraries, for pure generated ones, we have very little logs, which is something we are planning to improve as part of the observability project. Can we add something to indicate it as well or maybe remove this section?
|
Thanks Tomo, this is very helpful! FYI, we are planning to improve the whole logging experience as part of the Observability project, so a lot of things could change, but this guide is pretty accurate as of now. |
|
Looks good! IIRC, I have used this page previously for logging some of the HTTP requests for REGAPIC: http://googleapis.github.io/google-http-java-client/http-transport.html I think your guide should cover the cases. Just FYI if you wanted to add anything else. |
Thanks for then note Lawrence! I think it should be already covered by |
Document to explain how to change logging level for our libraries and underlying libraries.
Credit: I used @BenWhitehead 's snippet in bits benwhitehead/6166544285433856.