64 lines
2.3 KiB
Go
64 lines
2.3 KiB
Go
|
// Licensed to Elasticsearch B.V. under one or more contributor
|
||
|
|
// license agreements. See the NOTICE file distributed with
|
||
|
|
// this work for additional information regarding copyright
|
||
|
|
// ownership. Elasticsearch B.V. licenses this file to you under
|
||
|
|
// the Apache License, Version 2.0 (the "License"); you may
|
||
|
|
// not use this file except in compliance with the License.
|
||
|
|
// You may obtain a copy of the License at
|
||
|
|
//
|
||
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
//
|
||
|
|
// Unless required by applicable law or agreed to in writing,
|
||
|
|
// software distributed under the License is distributed on an
|
||
|
|
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||
|
|
// KIND, either express or implied. See the License for the
|
||
|
|
// specific language governing permissions and limitations
|
||
|
|
// under the License.
|
||
|
|
|
||
|
|
/*
|
||
|
|
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: maximum
|
||
|
|
* 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
|