/* SPDX-License-Identifier: GPL-2.0 */ /* * linux/include/linux/sunrpc/metrics.h * * Declarations for RPC client per-operation metrics * * Copyright (C) 2005 Chuck Lever <cel@netapp.com> * * RPC client per-operation statistics provide latency and retry * information about each type of RPC procedure in a given RPC program. * These statistics are not for detailed problem diagnosis, but simply * to indicate whether the problem is local or remote. * * These counters are not meant to be human-readable, but are meant to be * integrated into system monitoring tools such as "sar" and "iostat". As * such, the counters are sampled by the tools over time, and are never * zeroed after a file system is mounted. Moving averages can be computed * by the tools by taking the difference between two instantaneous samples * and dividing that by the time between the samples. * * The counters are maintained in a single array per RPC client, indexed * by procedure number. There is no need to maintain separate counter * arrays per-CPU because these counters are always modified behind locks. */ #ifndef _LINUX_SUNRPC_METRICS_H #define _LINUX_SUNRPC_METRICS_H #include <linux/seq_file.h> #include <linux/ktime.h> #include <linux/spinlock.h> #define RPC_IOSTATS_VERS "1.0" struct rpc_iostats { spinlock_t om_lock; /* * These counters give an idea about how many request * transmissions are required, on average, to complete that * particular procedure. Some procedures may require more * than one transmission because the server is unresponsive, * the client is retransmitting too aggressively, or the * requests are large and the network is congested. */ unsigned long om_ops, /* count of operations */ om_ntrans, /* count of RPC transmissions */ om_timeouts; /* count of major timeouts */ /* * These count how many bytes are sent and received for a * given RPC procedure type. This indicates how much load a * particular procedure is putting on the network. These * counts include the RPC and ULP headers, and the request * payload. */ unsigned long long om_bytes_sent, /* count of bytes out */ om_bytes_recv; /* count of bytes in */ /* * The length of time an RPC request waits in queue before * transmission, the network + server latency of the request, * and the total time the request spent from init to release * are measured. */ ktime_t om_queue, /* queued for xmit */ om_rtt, /* RPC RTT */ om_execute; /* RPC execution */ } ____cacheline_aligned; struct rpc_task; struct rpc_clnt; /* * EXPORTed functions for managing rpc_iostats structures */ #ifdef CONFIG_PROC_FS struct rpc_iostats * rpc_alloc_iostats(struct rpc_clnt *); void rpc_count_iostats(const struct rpc_task *, struct rpc_iostats *); void rpc_count_iostats_metrics(const struct rpc_task *, struct rpc_iostats *); void rpc_print_iostats(struct seq_file *, struct rpc_clnt *); void rpc_free_iostats(struct rpc_iostats *); #else /* CONFIG_PROC_FS */ static inline struct rpc_iostats *rpc_alloc_iostats(struct rpc_clnt *clnt) { return NULL; } static inline void rpc_count_iostats(const struct rpc_task *task, struct rpc_iostats *stats) {} static inline void rpc_count_iostats_metrics(const struct rpc_task *task, struct rpc_iostats *stats) { } static inline void rpc_print_iostats(struct seq_file *seq, struct rpc_clnt *clnt) {} static inline void rpc_free_iostats(struct rpc_iostats *stats) {} #endif /* CONFIG_PROC_FS */ #endif /* _LINUX_SUNRPC_METRICS_H */
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
addr.h | File | 4.94 KB | 0644 |
|
auth.h | File | 7.43 KB | 0644 |
|
auth_gss.h | File | 2.33 KB | 0644 |
|
bc_xprt.h | File | 2.42 KB | 0644 |
|
cache.h | File | 8.38 KB | 0644 |
|
clnt.h | File | 7.17 KB | 0644 |
|
debug.h | File | 2.76 KB | 0644 |
|
gss_api.h | File | 4.56 KB | 0644 |
|
gss_asn1.h | File | 3.11 KB | 0644 |
|
gss_err.h | File | 5.93 KB | 0644 |
|
gss_krb5.h | File | 11.15 KB | 0644 |
|
gss_krb5_enctypes.h | File | 123 B | 0644 |
|
metrics.h | File | 3.52 KB | 0644 |
|
msg_prot.h | File | 6.23 KB | 0644 |
|
rpc_pipe_fs.h | File | 3.92 KB | 0644 |
|
rpc_rdma.h | File | 3.81 KB | 0644 |
|
sched.h | File | 9.09 KB | 0644 |
|
stats.h | File | 2.01 KB | 0644 |
|
svc.h | File | 16.55 KB | 0644 |
|
svc_rdma.h | File | 7.43 KB | 0644 |
|
svc_xprt.h | File | 6.63 KB | 0644 |
|
svcauth.h | File | 6.11 KB | 0644 |
|
svcauth_gss.h | File | 824 B | 0644 |
|
svcsock.h | File | 2.06 KB | 0644 |
|
timer.h | File | 1.14 KB | 0644 |
|
types.h | File | 497 B | 0644 |
|
xdr.h | File | 12.73 KB | 0644 |
|
xprt.h | File | 14.77 KB | 0644 |
|
xprtmultipath.h | File | 2 KB | 0644 |
|
xprtrdma.h | File | 2.9 KB | 0644 |
|
xprtsock.h | File | 1.73 KB | 0644 |
|