libosmocore  1.6.0
Osmocom core library
stats.h
Go to the documentation of this file.
1 /*
2  * (C) 2015 by sysmocom - s.f.m.c. GmbH
3  *
4  * All Rights Reserved
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License along
17  * with this program; if not, write to the Free Software Foundation, Inc.,
18  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
19  *
20  */
21 #pragma once
22 
27 /* a bit of a crude way to disable building/using this on (bare iron)
28  * embedded systems. We cannot use the autoconf-defined HAVE_... macros
29  * here, as that only works at library compile time, not at application
30  * compile time */
31 #if defined(unix) || defined(__APPLE__)
32 
33 #include <sys/socket.h>
34 #include <arpa/inet.h>
35 
36 #include <osmocom/core/linuxlist.h>
37 
38 #include <stdint.h>
39 
40 struct msgb;
42 struct osmo_stat_item_desc;
43 struct rate_ctr_group;
44 struct rate_ctr_desc;
45 
52 };
53 
58 };
59 
65  char *name;
66 
67  unsigned int have_net_config : 1;
68 
69  /* config */
70  int enabled;
71  char *name_prefix;
72  char *dest_addr_str;
73  char *bind_addr_str;
74  int dest_port;
75  int mtu;
76  unsigned int flush_period;
80 
81  /* state */
82 
83  int running;
84  struct sockaddr dest_addr;
86  struct sockaddr bind_addr;
88  int fd;
89  struct msgb *buffer;
92  unsigned int flush_period_counter;
94  struct llist_head list;
95  int (*open)(struct osmo_stats_reporter *srep);
96  int (*close)(struct osmo_stats_reporter *srep);
97  int (*send_counter)(struct osmo_stats_reporter *srep,
98  const struct rate_ctr_group *ctrg,
99  const struct rate_ctr_desc *desc,
100  int64_t value, int64_t delta);
101  int (*send_item)(struct osmo_stats_reporter *srep,
102  const struct osmo_stat_item_group *statg,
103  const struct osmo_stat_item_desc *desc,
104  int64_t value);
105 };
106 
108  int interval;
109 };
110 
112 extern struct osmo_stats_config *osmo_stats_config;
113 
114 void osmo_stats_init(void *ctx);
115 int osmo_stats_report();
116 
118 
120  const char *name);
122 
124  const char *name);
125 
126 int osmo_stats_reporter_set_remote_addr(struct osmo_stats_reporter *srep, const char *addr);
128 int osmo_stats_reporter_set_local_addr(struct osmo_stats_reporter *srep, const char *addr);
131  enum osmo_stats_class class_id);
132 int osmo_stats_reporter_set_name_prefix(struct osmo_stats_reporter *srep, const char *prefix);
135 int osmo_stats_reporter_set_flush_period(struct osmo_stats_reporter *srep, unsigned int period);
136 
137 /* reporter creation */
140 
141 /* helper functions for reporter implementations */
142 int osmo_stats_reporter_send(struct osmo_stats_reporter *srep, const char *data,
143  int data_len);
147 
148 #endif /* unix || __APPLE__ */
enum osmo_sub_auth_type type
const char * name
uint8_t data[0]
struct osmo_stats_reporter * osmo_stats_reporter_alloc(enum osmo_stats_reporter_type type, const char *name)
Definition: stats.c:215
int osmo_stats_reporter_udp_open(struct osmo_stats_reporter *srep)
void osmo_stats_reporter_free(struct osmo_stats_reporter *srep)
Destroy a given stats_reporter.
Definition: stats.c:233
int osmo_stats_reporter_set_name_prefix(struct osmo_stats_reporter *srep, const char *prefix)
Set the name prefix of a given stats_reporter.
Definition: stats.c:416
int osmo_stats_reporter_set_flush_period(struct osmo_stats_reporter *srep, unsigned int period)
Set the regular flush period for a given stats_reporter.
Definition: stats.c:401
int osmo_stats_reporter_set_remote_port(struct osmo_stats_reporter *srep, int port)
int osmo_stats_reporter_disable(struct osmo_stats_reporter *srep)
Disable the given stats_reporter.
Definition: stats.c:439
int osmo_stats_report()
Definition: stats.c:783
int osmo_stats_reporter_set_max_class(struct osmo_stats_reporter *srep, enum osmo_stats_class class_id)
Definition: stats.c:367
int osmo_stats_reporter_set_mtu(struct osmo_stats_reporter *srep, int mtu)
struct osmo_stats_config * osmo_stats_config
Definition: stats.c:116
int osmo_stats_set_interval(int interval)
Set the reporting interval (common for all reporters)
Definition: stats.c:381
int osmo_stats_reporter_udp_close(struct osmo_stats_reporter *srep)
struct osmo_stats_reporter * osmo_stats_reporter_find(enum osmo_stats_reporter_type type, const char *name)
Find a stats_reporter of given type and name.
Definition: stats.c:253
struct osmo_stats_reporter * osmo_stats_reporter_create_statsd(const char *name)
Create a stats_reporter reporting to statsd.
Definition: stats_statsd.c:57
int osmo_stats_reporter_set_remote_addr(struct osmo_stats_reporter *srep, const char *addr)
osmo_stats_reporter_type
Statistics Reporter Type.
Definition: stats.h:55
struct osmo_stats_reporter * osmo_stats_reporter_create_log(const char *name)
Create a stats_reporter that logs via libosmocore logging.
Definition: stats.c:567
void osmo_stats_init(void *ctx)
Initialize the stats reporting module; call this once in your program.
Definition: stats.c:242
int osmo_stats_reporter_set_local_addr(struct osmo_stats_reporter *srep, const char *addr)
int osmo_stats_reporter_enable(struct osmo_stats_reporter *srep)
Enable the given stats_reporter.
Definition: stats.c:429
int osmo_stats_reporter_send_buffer(struct osmo_stats_reporter *srep)
int osmo_stats_reporter_send(struct osmo_stats_reporter *srep, const char *data, int data_len)
struct llist_head osmo_stats_reporter_list
osmo_stats_class
Statistics Class definitions.
Definition: stats.h:47
@ OSMO_STATS_REPORTER_LOG
libosmocore logging
Definition: stats.h:56
@ OSMO_STATS_REPORTER_STATSD
statsd backend
Definition: stats.h:57
@ OSMO_STATS_CLASS_UNKNOWN
unknown class
Definition: stats.h:48
@ OSMO_STATS_CLASS_PEER
peer in a communications link
Definition: stats.h:50
@ OSMO_STATS_CLASS_GLOBAL
global counter/stat_item
Definition: stats.h:49
@ OSMO_STATS_CLASS_SUBSCRIBER
subscriber
Definition: stats.h:51
Simple doubly linked list implementation.
(double) linked list header structure
Definition: linuxlist.h:46
Osmocom message buffer.
Definition: msgb.h:35
Statistics item description.
Definition: stat_item.h:22
One instance of a counter group class.
Definition: stat_item.h:45
Definition: stats.h:107
int interval
Definition: stats.h:108
One statistics reporter instance.
Definition: stats.h:61
unsigned int flush_period_counter
count sends between forced flushes
Definition: stats.h:92
int dest_port
destination (UDP) port
Definition: stats.h:74
int dest_addr_len
length of dest_addr in bytes
Definition: stats.h:85
struct sockaddr bind_addr
local bind address of socket
Definition: stats.h:86
int force_single_flush
set to 1 to force a flush (send even unchanged stats values)
Definition: stats.h:91
int(* send_counter)(struct osmo_stats_reporter *srep, const struct rate_ctr_group *ctrg, const struct rate_ctr_desc *desc, int64_t value, int64_t delta)
Definition: stats.h:97
unsigned int have_net_config
Definition: stats.h:67
int fd
file descriptor of socket
Definition: stats.h:88
int enabled
is this reporter enabled
Definition: stats.h:70
int(* close)(struct osmo_stats_reporter *srep)
Definition: stats.h:96
int mtu
Maximum Transmission Unit.
Definition: stats.h:75
int bind_addr_len
length of bind_addr in bytes
Definition: stats.h:87
enum osmo_stats_reporter_type type
Type of the reporter (log, statsd)
Definition: stats.h:63
int(* send_item)(struct osmo_stats_reporter *srep, const struct osmo_stat_item_group *statg, const struct osmo_stat_item_desc *desc, int64_t value)
Definition: stats.h:101
enum osmo_stats_class max_class
Maximum class/index to report.
Definition: stats.h:79
int agg_enabled
is aggregation enabled?
Definition: stats.h:90
struct msgb * buffer
message buffer for log output
Definition: stats.h:89
int(* open)(struct osmo_stats_reporter *srep)
Definition: stats.h:95
int running
is this reporter running
Definition: stats.h:83
char * name_prefix
prefix for counter names
Definition: stats.h:71
char * dest_addr_str
destination IP address
Definition: stats.h:72
struct llist_head list
Definition: stats.h:94
char * name
Human-readable name of this reporter.
Definition: stats.h:65
unsigned int flush_period
period between regular flushes
Definition: stats.h:76
struct sockaddr dest_addr
destination address of socket
Definition: stats.h:84
char * bind_addr_str
local bind IP address
Definition: stats.h:73
rate counter description
Definition: rate_ctr.h:37
One instance of a counter group class.
Definition: rate_ctr.h:57