kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-10-12 15:45:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge "res_statsd: Add functions that support variable arguments" into 13

Browse Source
This commit is contained in:
Matt Jordan
2015-11-23 08:43:29 -06:00
committed by Gerrit Code Review
parent 0f88f909ec 3354b325c6
commit 001b7f482b
2 changed files with 94 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
include/asterisk/statsd.h
View File

@@ -57,9 +57,31 @@ AST_OPTIONAL_API(void, ast_statsd_log_string, (const char *metric_name,
/*!
* \brief Send a stat to the configured statsd server.
* \since 13.7.0
*
* The is the most flexible function for sending a message to the statsd server,
* but also the least easy to use. See ast_statsd_log() or
* This is the most flexible function for sending a message to the statsd
* server. In addition to allowing the string value and sample rate to be specified,
* the metric_name can be formed as a printf style string with variable
* arguments.
*
* \param metric_name Format string (UTF-8) specifying the name of the metric.
* \param metric_type Type of metric to send.
* \param value Value to send.
* \param sample_rate Percentage of samples to send.
*
* Example Usage:
* \code
* ast_statsd_log_string_va(AST_STATSD_GUAGE, "+1", 1.0, "endpoints.states.%s", state_name);
* \endcode
*/
AST_OPTIONAL_API_ATTR(void, format(printf, 1, 5), ast_statsd_log_string_va,
(const char *metric_name, const char *metric_type, const char *value, double sample_rate, ...), {});
/*!
* \brief Send a stat to the configured statsd server.
*
* The is nearly the most flexible function for sending a message to the statsd
* server, but also the least easy to use. See ast_statsd_log() or
* ast_statsd_log_sample() for a slightly more convenient interface.
*
* \param metric_name String (UTF-8) name of the metric.
@@ -71,6 +93,28 @@ AST_OPTIONAL_API(void, ast_statsd_log_string, (const char *metric_name,
AST_OPTIONAL_API(void, ast_statsd_log_full, (const char *metric_name,
const char *metric_type, intmax_t value, double sample_rate), {});
/*!
* \brief Send a stat to the configured statsd server.
* \since 13.7.0
*
* This is the most flexible function for sending a message to the statsd
* server. In addition to allowing the value and sample rate to be specified,
* the metric_name can be formed as a printf style string with variable
* arguments.
*
* \param metric_name Format string (UTF-8) specifying the name of the metric.
* \param metric_type Type of metric to send.
* \param value Value to send.
* \param sample_rate Percentage of samples to send.
*
* Example Usage:
* \code
* ast_statsd_log_full_va(AST_STATSD_TIMER, rtt, 1.0, "endpoint.%s.rtt", endpoint_name);
* \endcode
*/
AST_OPTIONAL_API_ATTR(void, format(printf, 1, 5), ast_statsd_log_full_va,
(const char *metric_name, const char *metric_type, intmax_t value, double sample_rate, ...), {});
/*!
* \brief Send a stat to the configured statsd server.
* \param metric_name String (UTF-8) name of the metric.

48
res/res_statsd.c
View File

@@ -160,6 +160,54 @@ void AST_OPTIONAL_API_NAME(ast_statsd_log_full)(const char *metric_name,
}
AST_THREADSTORAGE(statsd_buf);
void AST_OPTIONAL_API_NAME(ast_statsd_log_string_va)(const char *metric_name,
const char *metric_type, const char *value, double sample_rate, ...)
{
struct ast_str *buf;
va_list ap;
int res;
buf = ast_str_thread_get(&statsd_buf, 128);
if (!buf) {
return;
}
va_start(ap, sample_rate);
res = ast_str_set_va(&buf, 0, metric_name, ap);
va_end(ap);
if (res == AST_DYNSTR_BUILD_FAILED) {
return;
}
ast_statsd_log_string(ast_str_buffer(buf), metric_type, value, sample_rate);
}
void AST_OPTIONAL_API_NAME(ast_statsd_log_full_va)(const char *metric_name,
const char *metric_type, intmax_t value, double sample_rate, ...)
{
struct ast_str *buf;
va_list ap;
int res;
buf = ast_str_thread_get(&statsd_buf, 128);
if (!buf) {
return;
}
va_start(ap, sample_rate);
res = ast_str_set_va(&buf, 0, metric_name, ap);
va_end(ap);
if (res == AST_DYNSTR_BUILD_FAILED) {
return;
}
ast_statsd_log_full(ast_str_buffer(buf), metric_type, value, sample_rate);
}
void AST_OPTIONAL_API_NAME(ast_statsd_log)(const char *metric_name,
const char *metric_type, intmax_t value)
{