Files
fn-serverless/vendor/google.golang.org/grpc/Documentation/log_levels.md
Reed Allman 51ff7caeb2 Bye bye openapi (#1081)
* add DateTime sans mgo

* change all uses of strfmt.DateTime to common.DateTime, remove test strfmt usage

* remove api tests, system-test dep on api test

multiple reasons to remove the api tests:

* awkward dependency with fn_go meant generating bindings on a branched fn to
vendor those to test new stuff. this is at a minimum not at all intuitive,
worth it, nor a fun way to spend the finite amount of time we have to live.
* api tests only tested a subset of functionality that the server/ api tests
already test, and we risk having tests where one tests some thing and the
other doesn't. let's not. we have too many test suites as it is, and these
pretty much only test that we updated the fn_go bindings, which is actually a
hassle as noted above and the cli will pretty quickly figure out anyway.
* fn_go relies on openapi, which relies on mgo, which is deprecated and we'd
like to remove as a dependency. openapi is a _huge_ dep built in a NIH
fashion, that cannot simply remove the mgo dep as users may be using it.
we've now stolen their date time and otherwise killed usage of it in fn core,
for fn_go it still exists but that's less of a problem.

* update deps

removals:

* easyjson
* mgo
* go-openapi
* mapstructure
* fn_go
* purell
* go-validator

also, had to lock docker. we shouldn't use docker on master anyway, they
strongly advise against that. had no luck with latest version rev, so i locked
it to what we were using before. until next time.

the rest is just playing dep roulette, those end up removing a ton tho

* fix exec test to work

* account for john le cache
2018-06-21 11:09:16 -07:00

1.5 KiB

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.