server.yml

# 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.
---
- name: server
  title: Server
  group: 2
  short: Fields about the server side of a network connection, used with client.
  description: >
    A Server is defined as the responder in a network connection for events regarding sessions, connections, or bidirectional flow records.

    For TCP events, the server is the receiver of the initial SYN packet(s) of the TCP connection.
    For other protocols, the server is generally the responder in the network transaction.
    Some systems actually use the term "responder" to refer the server in TCP connections.
    The server fields describe details about the system acting as the server in the network event.
    Server fields are usually populated in conjunction with client fields.
    Server fields are generally not populated for packet-level events.

    Client / server representations can add semantic context to an exchange,
    which is helpful to visualize the data in certain situations.
    If your context falls in that category, you should still ensure that source and destination are filled appropriately.
  type: group
  fields:

    - name: address
      level: extended
      type: keyword
      short: Server network address.
      description: >
        Some event server addresses are defined ambiguously. The event will
        sometimes list an IP, a domain or a unix socket.  You should always
        store the raw address in the `.address` field.

        Then it should be duplicated to `.ip` or `.domain`, depending on which
        one it is.

    - name: ip
      level: core
      type: ip
      short: IP address of the server.
      description: >
        IP address of the server (IPv4 or IPv6).

    - name: port
      format: string
      level: core
      type: long
      description: >
        Port of the server.

    - name: mac
      level: core
      type: keyword
      short: MAC address of the server.
      pattern: ^[A-F0-9]{2}(-[A-F0-9]{2}){5,}$
      example: 00-00-5E-00-53-23
      description: >
        MAC address of the server.

        The notation format from RFC 7042 is suggested: Each octet (that is, 8-bit byte) is
        represented by two [uppercase] hexadecimal digits giving the value of
        the octet as an unsigned integer. Successive octets are separated by a
        hyphen.

    - name: domain
      level: core
      type: keyword
      short: The domain name of the server.
      example: foo.example.com
      description: >
        The domain name of the server system.

        This value may be a host name, a fully qualified domain name, or another
        host naming format. The value may derive from the original event or be
        added from enrichment.

    - name: registered_domain
      level: extended
      type: keyword
      short: The highest registered server domain, stripped of the subdomain.
      description: >
        The highest registered server domain, stripped of the subdomain.

        For example, the registered domain for "foo.example.com" is "example.com".

        This value can be determined precisely with a list like the public
        suffix list (http://publicsuffix.org). Trying to approximate this by
        simply taking the last two labels will not work well for TLDs such as "co.uk".
      example: example.com

    - name: top_level_domain
      level: extended
      type: keyword
      short: The effective top level domain (com, org, net, co.uk).
      description: >
        The effective top level domain (eTLD), also known as the domain suffix,
        is the last part of the domain name.
        For example, the top level domain for example.com is "com".

        This value can be determined precisely with a list like the public
        suffix list (http://publicsuffix.org). Trying to approximate this by
        simply taking the last label will not work well for effective TLDs such as "co.uk".
      example: co.uk

    - name: subdomain
      level: extended
      type: keyword
      short: The subdomain of the domain.
      description: >
        The subdomain portion of a fully qualified domain name includes all of the names except
        the host name under the registered_domain.  In a partially qualified domain, or if the
        the qualification level of the full name cannot be determined, subdomain contains all of
        the names below the registered domain.

        For example the subdomain portion of "www.east.mydomain.co.uk" is "east".
        If the domain has multiple levels of subdomain, such as "sub2.sub1.example.com",
        the subdomain field should contain "sub2.sub1", with no trailing period.
      example: east

    # Metrics
    - name: bytes
      format: bytes
      level: core
      type: long
      example: 184
      description: >
        Bytes sent from the server to the client.

    - name: packets
      level: core
      type: long
      example: 12
      description: >
        Packets sent from the server to the client.

    - name: nat.ip
      level: extended
      type: ip
      short: Server NAT ip
      description: >
        Translated ip of destination based NAT sessions (e.g. internet to private DMZ)

        Typically used with load balancers, firewalls, or routers.

    - name: nat.port
      format: string
      level: extended
      type: long
      short: Server NAT port
      description: >
        Translated port of destination based NAT sessions (e.g. internet to private DMZ)

        Typically used with load balancers, firewalls, or routers.