blob: c8bb2be34bf5f443472c3f6d016a20e62a31b4b8 [file] [log] [blame]
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -07001/*
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
amit.ghosh258d14c2020-10-02 15:13:38 +020029import (
30 "os"
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070031
amit.ghosh258d14c2020-10-02 15:13:38 +020032 "google.golang.org/grpc/internal/grpclog"
33)
34
35func init() {
36 SetLoggerV2(newLoggerV2())
37}
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070038
39// V reports whether verbosity level l is at least the requested verbose level.
40func V(l int) bool {
amit.ghosh258d14c2020-10-02 15:13:38 +020041 return grpclog.Logger.V(l)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070042}
43
44// Info logs to the INFO log.
45func Info(args ...interface{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +020046 grpclog.Logger.Info(args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070047}
48
49// Infof logs to the INFO log. Arguments are handled in the manner of fmt.Printf.
50func Infof(format string, args ...interface{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +020051 grpclog.Logger.Infof(format, args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070052}
53
54// Infoln logs to the INFO log. Arguments are handled in the manner of fmt.Println.
55func Infoln(args ...interface{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +020056 grpclog.Logger.Infoln(args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070057}
58
59// Warning logs to the WARNING log.
60func Warning(args ...interface{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +020061 grpclog.Logger.Warning(args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070062}
63
64// Warningf logs to the WARNING log. Arguments are handled in the manner of fmt.Printf.
65func Warningf(format string, args ...interface{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +020066 grpclog.Logger.Warningf(format, args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070067}
68
69// Warningln logs to the WARNING log. Arguments are handled in the manner of fmt.Println.
70func Warningln(args ...interface{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +020071 grpclog.Logger.Warningln(args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070072}
73
74// Error logs to the ERROR log.
75func Error(args ...interface{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +020076 grpclog.Logger.Error(args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070077}
78
79// Errorf logs to the ERROR log. Arguments are handled in the manner of fmt.Printf.
80func Errorf(format string, args ...interface{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +020081 grpclog.Logger.Errorf(format, args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070082}
83
84// Errorln logs to the ERROR log. Arguments are handled in the manner of fmt.Println.
85func Errorln(args ...interface{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +020086 grpclog.Logger.Errorln(args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070087}
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{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +020092 grpclog.Logger.Fatal(args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070093 // 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.
Arjun E K57a7fcb2020-01-30 06:44:45 +000098// It calls os.Exit() with exit code 1.
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -070099func Fatalf(format string, args ...interface{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +0200100 grpclog.Logger.Fatalf(format, args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -0700101 // 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{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +0200108 grpclog.Logger.Fatalln(args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -0700109 // 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{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +0200117 grpclog.Logger.Info(args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -0700118}
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{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +0200124 grpclog.Logger.Infof(format, args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -0700125}
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{}) {
amit.ghosh258d14c2020-10-02 15:13:38 +0200131 grpclog.Logger.Infoln(args...)
Matteo Scandoloa6a3aee2019-11-26 13:30:14 -0700132}