View source
<?php
function statsd_admin_settings() {
$form['statsd_enabled'] = array(
'#type' => 'checkbox',
'#title' => t('Enable StatsD'),
'#description' => t('Enable StatsD logging. You may want to disable this in non-production environments.'),
'#default_value' => variable_get('statsd_enabled', FALSE),
);
$form['statsd_host'] = array(
'#type' => 'textfield',
'#title' => t('Host'),
'#size' => 25,
'#description' => t('The hostname, or IP address of the StatsD daemon. To minimize latency issue, use an IP whenever possible.'),
'#default_value' => variable_get('statsd_host', '127.0.0.1'),
);
$form['statsd_port'] = array(
'#type' => 'textfield',
'#title' => t('Port'),
'#size' => 5,
'#description' => t('The port of the StatsD daemon'),
'#default_value' => variable_get('statsd_port', 8125),
);
$form['statsd_timeout'] = array(
'#type' => 'textfield',
'#title' => t('Timeout'),
'#size' => 3,
'#description' => t('Timeout (in seconds) for the StatsD daemon when sending data.'),
'#default_value' => variable_get('statsd_timeout', ini_get('default_socket_timeout')),
);
$form['events'] = array(
'#type' => 'fieldset',
'#title' => t('Events'),
'#collapsible' => TRUE,
);
$form['events']['statsd_user_events'] = array(
'#type' => 'checkbox',
'#title' => t('Send User Events'),
'#description' => t('Captures various user events in the following categories: active sessions, successful logins, failed logins, page views'),
'#default_value' => variable_get('statsd_user_events', TRUE),
);
$form['events']['statsd_performance_events'] = array(
'#type' => 'checkbox',
'#title' => t('Send Performance Events'),
'#description' => t('Captures various performance events including peak memory usage and page execution time.'),
'#default_value' => variable_get('statsd_performance_events', TRUE),
);
$form['events']['statsd_watchdog_events'] = array(
'#type' => 'checkbox',
'#title' => t('Send Watchdog Events'),
'#description' => t('Captures the severity and type of errors passed through watchdog.'),
'#default_value' => variable_get('statsd_watchdog_events', TRUE),
);
$form['events']['statsd_watchdog_level'] = array(
'#type' => 'select',
'#title' => t('Log Level'),
'#description' => t('If watchdog events are enabled, only send data to StatsD at or above the selected threshold'),
'#options' => watchdog_severity_levels(),
'#default_value' => variable_get('statsd_watchdog_level', WATCHDOG_WARNING),
);
$form['statsd_sample_rate'] = array(
'#type' => 'textfield',
'#title' => t('Sample Rate'),
'#size' => 2,
'#description' => t('StatsD can send a subset of events to Graphite. Choose a lower sample rate if you want to reduce the number of events being sent. Sample rates are between 0 and 1 (e.g. 0.1 implies 10% of events will be logged)'),
'#default_value' => variable_get('statsd_sample_rate', 1),
);
$form['statsd_prefix'] = array(
'#type' => 'textfield',
'#title' => t('Prefix'),
'#size' => 15,
'#description' => t('Use a prefix if you need to separate similar events (such as on different web servers). This prefix is added for calls (if enabled), as well as any calls via the built-in StatsD client. Do not include the period at the end of the prefix (e.g. use "myprefix" instead of "myprefix."'),
'#default_value' => variable_get('statsd_prefix', NULL),
);
$form['statsd_suffix'] = array(
'#type' => 'textfield',
'#title' => t('Suffix'),
'#size' => 15,
'#description' => t('Use a suffix if you need to separate similar events (such as on different web servers). This suffix is added for calls (if enabled), as well as any calls via the built-in StatsD client. Do not include the period at the beginning of the suffix (e.g. use "mysuffix" instead of "mysuffix."'),
'#default_value' => variable_get('statsd_suffix', NULL),
);
$form['statsd_series_replacement'] = array(
'#type' => 'textfield',
'#title' => t('Replacement'),
'#size' => 15,
'#description' => t('Replace illegal characters in the watchdog type with this value.'),
'#default_value' => variable_get('statsd_series_replacement', '-'),
);
return system_settings_form($form);
}
function statsd_admin_settings_validate($form, &$form_state) {
$form_state['values']['statsd_host'] = trim($form_state['values']['statsd_host']);
$form_state['values']['statsd_port'] = trim($form_state['values']['statsd_port']);
$form_state['values']['statsd_timeout'] = trim($form_state['values']['statsd_timeout']);
$form_state['values']['statsd_sample_rate'] = trim($form_state['values']['statsd_sample_rate']);
$form_state['values']['statsd_prefix'] = trim(rtrim($form_state['values']['statsd_prefix'], '.'));
$form_state['values']['statsd_suffix'] = trim(ltrim($form_state['values']['statsd_suffix'], '.'));
$form_state['values']['statsd_series_replacement'] = trim($form_state['values']['statsd_series_replacement']);
$sample_rate = $form_state['values']['statsd_sample_rate'];
if (!is_numeric($sample_rate) || $sample_rate <= 0 || $sample_rate > 1) {
form_set_error('statsd_sample_rate', t('The sample rate must be a value between 0 and 1'));
}
$statsd_prefix = $form_state['values']['statsd_prefix'];
if (preg_match(STATSD_SERIES_INVALID_CHARACTERS, $statsd_prefix)) {
form_set_error('statsd_prefix', t('The prefix cannot contain invalid characters for Graphite series names.'));
}
$statsd_suffix = $form_state['values']['statsd_suffix'];
if (preg_match(STATSD_SERIES_INVALID_CHARACTERS, $statsd_suffix)) {
form_set_error('statsd_suffix', t('The suffix cannot contain invalid characters for Graphite series names.'));
}
$series_replacement = $form_state['values']['statsd_series_replacement'];
if (preg_match(STATSD_SERIES_INVALID_CHARACTERS, $series_replacement)) {
form_set_error('statsd_series_replacement', t('The replacement value cannot contain invalid characters for Graphite series names.'));
}
}
