nJAMS Agent

The nJAMS Agent plugin gathers stats on nJAMS Agent itself.

Configuration:

# Configuration for nJams Agent agent
[agent]
## Default data collection interval for all inputs
interval = "10s"
## Rounds collection interval to 'interval'
## ie, if interval="10s" then always collect on :00, :10, :20, etc.
round_interval = true

## nJams Agent will send metrics to outputs in batches of at most
## metric_batch_size metrics.
## This controls the size of writes that nJams Agent sends to output plugins.
metric_batch_size = 1000

## For failed writes, nJams Agent will cache metric_buffer_limit metrics for each
## output, and will flush this buffer on a successful write. Oldest metrics
## are dropped first when this buffer fills.
## This buffer only fills when writes fail to output plugin(s).
metric_buffer_limit = 10000

## Collection jitter is used to jitter the collection by a random amount.
## Each plugin will sleep for a random time within jitter before collecting.
## This can be used to avoid many plugins querying things like sysfs at the
## same time, which can have a measurable effect on the system.
collection_jitter = "0s"

## Default flushing interval for all outputs. You shouldn't set this below
## interval. Maximum flush_interval will be flush_interval + flush_jitter
flush_interval = "10s"
## Jitter the flush interval by a random amount. This is primarily to avoid
## large write spikes for users running a large number of nJams Agent instances.
## ie, a jitter of 5s and interval 10s means flushes will happen every 10-15s
flush_jitter = "0s"

## By default or when set to "0s", precision will be set to the same
## timestamp order as the collection interval, with the maximum being 1s.
##   ie, when interval = "10s", precision will be "1s"
##       when interval = "250ms", precision will be "1ms"
## Precision will NOT be used for service inputs. It is up to each individual
## service input to set the timestamp at the appropriate precision.
## Valid time units are "ns", "us" (or "µs"), "ms", "s".
precision = ""

## Logging configuration:
## Run nJams Agent with debug log messages.
debug = false
## Run nJams Agent in quiet mode (error log messages only).
quiet = false
## Specify the log file name. The empty string means to log to stderr.
logfile = ""

## Override default hostname, if empty use os.Hostname()
hostname = ""
## If set to true, do no set the "host" tag in the nJams Agent agent.
omit_hostname = false

Example Output:

{
    "fields": {
        "cpu_time": 0,
        "cpu_time_guest": 0,
        "cpu_time_guest_nice": 0,
        "cpu_time_idle": 0,
        "cpu_time_iowait": 0,
        "cpu_time_irq": 0,
        "cpu_time_nice": 0,
        "cpu_time_soft_irq": 0,
        "cpu_time_steal": 0,
        "cpu_time_stolen": 0,
        "cpu_time_system": 0.05,
        "cpu_time_user": 0.07,
        "involuntary_context_switches": 1,
        "memory_data": 550916096,
        "memory_locked": 0,
        "memory_rss": 28262400,
        "memory_stack": 139264,
        "memory_swap": 0,
        "memory_vms": 604983296,
        "nice_priority": 20,
        "num_fds": 7,
        "num_threads": 14,
        "pid": 26256,
        "read_bytes": 0,
        "read_count": 403,
        "realtime_priority": 0,
        "rlimit_cpu_time_hard": 2147483647,
        "rlimit_cpu_time_soft": 2147483647,
        "rlimit_file_locks_hard": 2147483647,
        "rlimit_file_locks_soft": 2147483647,
        "rlimit_memory_data_hard": 2147483647,
        "rlimit_memory_data_soft": 2147483647,
        "rlimit_memory_locked_hard": 2147483647,
        "rlimit_memory_locked_soft": 2147483647,
        "rlimit_memory_rss_hard": 2147483647,
        "rlimit_memory_rss_soft": 2147483647,
        "rlimit_memory_stack_hard": 2147483647,
        "rlimit_memory_stack_soft": 8388608,
        "rlimit_memory_vms_hard": 2147483647,
        "rlimit_memory_vms_soft": 2147483647,
        "rlimit_nice_priority_hard": 0,
        "rlimit_nice_priority_soft": 0,
        "rlimit_num_fds_hard": 150000,
        "rlimit_num_fds_soft": 50000,
        "rlimit_realtime_priority_hard": 0,
        "rlimit_realtime_priority_soft": 0,
        "rlimit_signals_pending_hard": 31220,
        "rlimit_signals_pending_soft": 31220,
        "signals_pending": 0,
        "voluntary_context_switches": 548,
        "write_bytes": 0,
        "write_count": 10
    },
    "name": "njams_agent_unix",
    "tags": {
        "containerid": "vslems01",
        "exe": "njams_agent",
        "host": "vslems01",
        "id": "njams-agent-vslems01",
        "process_name": "njams_agent",
        "type": "njams_agent_unix",
        "user": "tibco"
    },
    "timestamp": 1576004640
}