blob: c8bb2be34bf5f443472c3f6d016a20e62a31b4b8 [file] [log] [blame]
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +00001/*
2 *
3 * Copyright 2017 gRPC authors.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 *
17 */
18
19// Package grpclog defines logging for grpc.
20//
21// All logs in transport and grpclb packages only go to verbose level 2.
22// All logs in other packages in grpc are logged in spite of the verbosity level.
23//
24// In the default logger,
25// severity level can be set by environment variable GRPC_GO_LOG_SEVERITY_LEVEL,
26// verbosity level can be set by GRPC_GO_LOG_VERBOSITY_LEVEL.
27package grpclog // import "google.golang.org/grpc/grpclog"
28
Scott Baker105df152020-04-13 15:55:14 -070029import (
30 "os"
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000031
Scott Baker105df152020-04-13 15:55:14 -070032 "google.golang.org/grpc/internal/grpclog"
33)
34
35func init() {
36 SetLoggerV2(newLoggerV2())
37}
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000038
39// V reports whether verbosity level l is at least the requested verbose level.
40func V(l int) bool {
Scott Baker105df152020-04-13 15:55:14 -070041 return grpclog.Logger.V(l)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000042}
43
44// Info logs to the INFO log.
45func Info(args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -070046 grpclog.Logger.Info(args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000047}
48
49// Infof logs to the INFO log. Arguments are handled in the manner of fmt.Printf.
50func Infof(format string, args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -070051 grpclog.Logger.Infof(format, args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000052}
53
54// Infoln logs to the INFO log. Arguments are handled in the manner of fmt.Println.
55func Infoln(args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -070056 grpclog.Logger.Infoln(args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000057}
58
59// Warning logs to the WARNING log.
60func Warning(args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -070061 grpclog.Logger.Warning(args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000062}
63
64// Warningf logs to the WARNING log. Arguments are handled in the manner of fmt.Printf.
65func Warningf(format string, args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -070066 grpclog.Logger.Warningf(format, args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000067}
68
69// Warningln logs to the WARNING log. Arguments are handled in the manner of fmt.Println.
70func Warningln(args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -070071 grpclog.Logger.Warningln(args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000072}
73
74// Error logs to the ERROR log.
75func Error(args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -070076 grpclog.Logger.Error(args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000077}
78
79// Errorf logs to the ERROR log. Arguments are handled in the manner of fmt.Printf.
80func Errorf(format string, args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -070081 grpclog.Logger.Errorf(format, args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000082}
83
84// Errorln logs to the ERROR log. Arguments are handled in the manner of fmt.Println.
85func Errorln(args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -070086 grpclog.Logger.Errorln(args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000087}
88
89// Fatal logs to the FATAL log. Arguments are handled in the manner of fmt.Print.
90// It calls os.Exit() with exit code 1.
91func Fatal(args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -070092 grpclog.Logger.Fatal(args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +000093 // Make sure fatal logs will exit.
94 os.Exit(1)
95}
96
97// Fatalf logs to the FATAL log. Arguments are handled in the manner of fmt.Printf.
98// It calls os.Exit() with exit code 1.
99func Fatalf(format string, args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -0700100 grpclog.Logger.Fatalf(format, args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +0000101 // Make sure fatal logs will exit.
102 os.Exit(1)
103}
104
105// Fatalln logs to the FATAL log. Arguments are handled in the manner of fmt.Println.
106// It calle os.Exit()) with exit code 1.
107func Fatalln(args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -0700108 grpclog.Logger.Fatalln(args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +0000109 // Make sure fatal logs will exit.
110 os.Exit(1)
111}
112
113// Print prints to the logger. Arguments are handled in the manner of fmt.Print.
114//
115// Deprecated: use Info.
116func Print(args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -0700117 grpclog.Logger.Info(args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +0000118}
119
120// Printf prints to the logger. Arguments are handled in the manner of fmt.Printf.
121//
122// Deprecated: use Infof.
123func Printf(format string, args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -0700124 grpclog.Logger.Infof(format, args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +0000125}
126
127// Println prints to the logger. Arguments are handled in the manner of fmt.Println.
128//
129// Deprecated: use Infoln.
130func Println(args ...interface{}) {
Scott Baker105df152020-04-13 15:55:14 -0700131 grpclog.Logger.Infoln(args...)
Dinesh Belwalkare63f7f92019-11-22 23:11:16 +0000132}