1 /* 2 * 3 * Copyright 2018 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 #ifndef GRPCPP_OPENCENSUS_H 20 #define GRPCPP_OPENCENSUS_H 21 22 #ifndef GRPC_BAZEL_BUILD 23 #error OpenCensus for gRPC is only supported when building with bazel. 24 #endif 25 26 #include "opencensus/trace/span.h" 27 28 namespace grpc { 29 // These symbols in this file will not be included in the binary unless 30 // grpc_opencensus_plugin build target was added as a dependency. At the moment 31 // it is only setup to be built with Bazel. 32 33 // Registers the OpenCensus plugin with gRPC, so that it will be used for future 34 // RPCs. This must be called before any views are created. 35 void RegisterOpenCensusPlugin(); 36 37 // RPC stats definitions, defined by 38 // https://github.com/census-instrumentation/opencensus-specs/blob/master/stats/gRPC.md 39 40 // Registers the cumulative gRPC views so that they will be exported by any 41 // registered stats exporter. For on-task stats, construct a View using the 42 // ViewDescriptors below. 43 void RegisterOpenCensusViewsForExport(); 44 45 class ServerContext; 46 47 // Returns the tracing Span for the current RPC. 48 ::opencensus::trace::Span GetSpanFromServerContext(ServerContext* context); 49 50 } // namespace grpc 51 52 #endif // GRPCPP_OPENCENSUS_H 53