e241b33f26
Some checks failed
codecov / upload (push) Failing after 13m59s
CodeQL / Analyze (push) Failing after 1s
Testing / vet-proto (push) Failing after 1s
Testing / tests (arm, latest) (push) Waiting to run
Testing / extras (latest) (push) Failing after 1s
Testing / static checks (latest-1) (push) Failing after 1s
Testing / tests (-race, latest) (push) Failing after 1s
Testing / tests (i386, latest) (push) Failing after 1s
Testing / tests (latest) (push) Failing after 1s
Testing / tests (latest-1) (push) Failing after 1s
Lock Threads / lock (push) Failing after 1s
govulncheck / govulncheck (.) (push) Failing after 1s
govulncheck / govulncheck (./cmd/protoc-gen-go-grpc) (push) Failing after 1s
govulncheck / govulncheck (./gcp/observability) (push) Failing after 1s
govulncheck / govulncheck (./security/advancedtls) (push) Failing after 1s
govulncheck / govulncheck (./stats/opencensus) (push) Failing after 1s
Stale bot / stale (push) Failing after 1s
50 lines
1.5 KiB
Markdown
50 lines
1.5 KiB
Markdown
# Log Levels
|
|
|
|
This document describes the different log levels supported by the grpc-go
|
|
library, and under what conditions they should be used.
|
|
|
|
### Info
|
|
|
|
Info messages are for informational purposes and may aid in the debugging of
|
|
applications or the gRPC library.
|
|
|
|
Examples:
|
|
- The name resolver received an update.
|
|
- The balancer updated its picker.
|
|
- Significant gRPC state is changing.
|
|
|
|
At verbosity of 0 (the default), any single info message should not be output
|
|
more than once every 5 minutes under normal operation.
|
|
|
|
### Warning
|
|
|
|
Warning messages indicate problems that are non-fatal for the application, but
|
|
could lead to unexpected behavior or subsequent errors.
|
|
|
|
Examples:
|
|
- Resolver could not resolve target name.
|
|
- Error received while connecting to a server.
|
|
- Lost or corrupt connection with remote endpoint.
|
|
|
|
### Error
|
|
|
|
Error messages represent errors in the usage of gRPC that cannot be returned to
|
|
the application as errors, or internal gRPC-Go errors that are recoverable.
|
|
|
|
Internal errors are detected during gRPC tests and will result in test failures.
|
|
|
|
Examples:
|
|
- Invalid arguments passed to a function that cannot return an error.
|
|
- An internal error that cannot be returned or would be inappropriate to return
|
|
to the user.
|
|
|
|
### Fatal
|
|
|
|
Fatal errors are severe internal errors that are unrecoverable. These lead
|
|
directly to panics, and are avoided as much as possible.
|
|
|
|
Example:
|
|
- Internal invariant was violated.
|
|
- User attempted an action that cannot return an error gracefully, but would
|
|
lead to an invalid state if performed.
|