// 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