xref: /aosp_15_r20/external/grpc-grpc/include/grpc/load_reporting.h (revision cc02d7e222339f7a4f6ba5f422e6413f4bd931f2)
1*cc02d7e2SAndroid Build Coastguard Worker /*
2*cc02d7e2SAndroid Build Coastguard Worker  *
3*cc02d7e2SAndroid Build Coastguard Worker  * Copyright 2017 gRPC authors.
4*cc02d7e2SAndroid Build Coastguard Worker  *
5*cc02d7e2SAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
6*cc02d7e2SAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
7*cc02d7e2SAndroid Build Coastguard Worker  * You may obtain a copy of the License at
8*cc02d7e2SAndroid Build Coastguard Worker  *
9*cc02d7e2SAndroid Build Coastguard Worker  *     http://www.apache.org/licenses/LICENSE-2.0
10*cc02d7e2SAndroid Build Coastguard Worker  *
11*cc02d7e2SAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
12*cc02d7e2SAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
13*cc02d7e2SAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14*cc02d7e2SAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
15*cc02d7e2SAndroid Build Coastguard Worker  * limitations under the License.
16*cc02d7e2SAndroid Build Coastguard Worker  *
17*cc02d7e2SAndroid Build Coastguard Worker  */
18*cc02d7e2SAndroid Build Coastguard Worker 
19*cc02d7e2SAndroid Build Coastguard Worker #ifndef GRPC_LOAD_REPORTING_H
20*cc02d7e2SAndroid Build Coastguard Worker #define GRPC_LOAD_REPORTING_H
21*cc02d7e2SAndroid Build Coastguard Worker 
22*cc02d7e2SAndroid Build Coastguard Worker #include <grpc/support/port_platform.h>
23*cc02d7e2SAndroid Build Coastguard Worker 
24*cc02d7e2SAndroid Build Coastguard Worker #ifdef __cplusplus
25*cc02d7e2SAndroid Build Coastguard Worker extern "C" {
26*cc02d7e2SAndroid Build Coastguard Worker #endif
27*cc02d7e2SAndroid Build Coastguard Worker 
28*cc02d7e2SAndroid Build Coastguard Worker /** Metadata key for the gRPC LB load balancer token.
29*cc02d7e2SAndroid Build Coastguard Worker  *
30*cc02d7e2SAndroid Build Coastguard Worker  * The value corresponding to this key is an opaque token that is given to the
31*cc02d7e2SAndroid Build Coastguard Worker  * frontend as part of each pick; the frontend sends this token to the backend
32*cc02d7e2SAndroid Build Coastguard Worker  * in each request it sends when using that pick. The token is used by the
33*cc02d7e2SAndroid Build Coastguard Worker  * backend to verify the request and to allow the backend to report load to the
34*cc02d7e2SAndroid Build Coastguard Worker  * gRPC LB system. */
35*cc02d7e2SAndroid Build Coastguard Worker #define GRPC_LB_TOKEN_MD_KEY "lb-token"
36*cc02d7e2SAndroid Build Coastguard Worker 
37*cc02d7e2SAndroid Build Coastguard Worker /** Metadata key for gRPC LB cost reporting.
38*cc02d7e2SAndroid Build Coastguard Worker  *
39*cc02d7e2SAndroid Build Coastguard Worker  * The value corresponding to this key is an opaque binary blob reported by the
40*cc02d7e2SAndroid Build Coastguard Worker  * backend as part of its trailing metadata containing cost information for the
41*cc02d7e2SAndroid Build Coastguard Worker  * call. */
42*cc02d7e2SAndroid Build Coastguard Worker #define GRPC_LB_COST_MD_KEY "lb-cost-bin"
43*cc02d7e2SAndroid Build Coastguard Worker 
44*cc02d7e2SAndroid Build Coastguard Worker #ifdef __cplusplus
45*cc02d7e2SAndroid Build Coastguard Worker }
46*cc02d7e2SAndroid Build Coastguard Worker #endif
47*cc02d7e2SAndroid Build Coastguard Worker 
48*cc02d7e2SAndroid Build Coastguard Worker #endif /* GRPC_LOAD_REPORTING_H */
49