forked from elastic/beats
-
Notifications
You must be signed in to change notification settings - Fork 0
/
doc.go
46 lines (36 loc) · 1.58 KB
/
doc.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
/*
Package module contains Metricbeat modules and their MetricSet implementations.
= Naming conventions
For the key names, metricbeat follows the naming conventions below:
* all field keys lower case
* snake case for combining words
* Group related fields in sub documents, which means using the . notation. Groups are mostly described by common prefixes.
* Prevent namespace duplication. If connections appears in the namespace, it's not needed in the sub document
* Do not use complex abbreviations. A list of standardised abbreviations can be found below.
* Organise the documents from the general to the details, which allows namespacing. The type should always be last, like .pct.
* If two fields are the same but with different units, remove the less granular one
* In case the value correlates with the name of a nested document, use value inside the document
* Do not use . in the names
* Use singular and plural properly for the fields. Example: sec_per_request vs open_requests
* Use singular names for metricsets. It easier to read the event created: system.process.load = 0.3
The goal is to have a similar experience across all metrics.
= Abbrevations
List of standardised words and units across all metricsets. On the left are the ones to be used, on the right the options seen in metricsets.
* avg: average
* connection: conn
* count:
* day: days, d
* der: derivative
* max: maximumg
* min: minimum
* pct: percentage
* request: req
* sec: seconds, second, s
* ms: millisecond, millis
* mb: megabytes
* msg: message
* ns: nanoseconds
* norm: normalized
* us: microseconds
*/
package module