What is "Agent"?
In this context, we call a worker which collects specific type of metrics, an agent.
How to use them
To be able to use any of agents, first you must import them.
Importing is done via config, by adding them under agents
section
An example config could look like this:
---
interval: 10
loglevel: DEBUG
riemann:
host: localhost
port: 5555
transport: BlankTransport
agents:
- name: echo
module: oshino.agents.subprocess_agent.SubprocessAgent
script: "echo 'Hello world!'"
tag: "bash"
More configuration info can be found under Config
As you can see, there's one agent in agents array, which is called echo
and uses internal SubprocessAgent
class.
This type of agent is able to execute command in command line
and return it's result as a metric.
Internal agents also includes HttpAgent
which is able to do HTTP calls,
and returns response and time it took to execute as metrics.
Usual source of agents is Third Party agent section
They can be installed via pip
command, or using oshino-admin
.
For more information on oshino-admin
usage, do oshino-admin --help
.
Creating custom Agent
It can be done by using our Cookiecutter Template