Fully Qualified Name¶
The Fully Qualified Name, or “FQN” is the address of a group, node, service, or a data source in munin.
It is most often used when configuring graphs which has no single corresponding plugin, but borrow data sources from other services.
Group FQN¶
The group FQN consists of one or more components, separated with a semicolon.
Note
If a node is configured without a group, the domain of the hostname becomes the group.
Examples
example.com
-----------
|
`--- group "example.com"
acme;webservers
---- ----------
| |
| `--- group "webservers"
`-------- group "acme"
Node FQN¶
The fully qualified name to a node consists of a group FQN, a semicolon, and a hostname.
Examples:
example.com;foo.example.com
----------- ---------------
| |
| `--- node "foo.example.com"
`--------------- group "example.com"
acme;webservers;www1.example.net
---- ---------- ----------------
| | |
| | `-------------- node "www1.example.net"
| `------------------------- group "webservers"
`------------------------------ group "acme"
Service FQN¶
The fully qualified name to a service consists of a node FQN, a colon, and a service name.
Note
A simple munin plugin will provide a service with the same name as the plugin. A multigraph plugin will provide one or more services, with arbitrary names.
Example:
acme;webservers;www1.example.net:https_requests
---- ---------- ---------------- --------------
| | | |
| | | `--- service "https_requests"
| | `-------------------- node "www1.example.net"
| `------------------------------- group "webservers"
`------------------------------------ group "acme"
Data source FQN¶
The fully qualified name to a data source consists of a service fqn, a dot, and a data source name.
Note: A data source normally corresponds to one line in a graph.
Example:
acme;webservers;www1.example.net:https_requests.denied
---- ---------- ---------------- -------------- ------
| | | | |
| | | | `--- data source "denied"
| | | `------------------ service "https_requests"
| | `----------------------------------- node "www1.example.net"
| `---------------------------------------------- group "webservers"
`--------------------------------------------------- group "acme"