Álex Ruiz f04d6fcd90
Migrate code and documentation from wazuh-indexer (#265)
* Migrate code and documentation from wazuh-indexer

* Migrate operational--integrations_maintenance_request.md

* Add ECS folder and workflow

* Add ECS workflow badge

* Adapt ECS workflow generator

* Trigger workflow

* Update ECS templates for modified modules: agent alerts command states-fim states-inventory-hardware states-inventory-hotfixes states-inventory-networks states-inventory-packages states-inventory-ports states-inventory-processes states-inventory-system states-vulnerabilities

* Remove unused code

* Update ECS templates for modified modules: agent alerts command states-fim states-inventory-hardware states-inventory-hotfixes states-inventory-networks states-inventory-packages states-inventory-ports states-inventory-processes states-inventory-system states-vulnerabilities

* Clean-up

---------

Co-authored-by: Wazuh Indexer Bot <github_devel_xdrsiem_indexer@wazuh.com>
2025-02-10 18:13:14 +01:00

3.4 KiB

agents index data model

Fields summary

The fields are based on https://github.com/wazuh/wazuh/issues/23396#issuecomment-2176402993

Based on ECS Agent Fields.

Field Type Description Example
agent.id keyword Unique identifier of this agent. 8a4f500d
agent.name keyword Custom name of the agent. foo
* agent.groups keyword List of groups the agent belong to. ["group1", "group2"]
* agent.key keyword The registration key of the agent. BfDbq0PpcLl9iWatJjY1shGvuQ4KXyOR
agent.type keyword Type of agent. endpoint
agent.version keyword Version of the agent. 6.0.0-rc2
* agent.is_connected boolean Agents' interpreted connection status depending on agent.last_login.
* agent.last_login date The last time the agent logged in. 11/11/2024 00:00:00
host.ip ip Host IP addresses. Note: this field should contain an array of values. ["192.168.56.11", "10.54.27.1"]
host.os.full keyword Operating system name, including the version or code name. Mac OS Mojave

* Custom field.

ECS mapping

---
name: agent
fields:
  base:
    fields:
      tags: []
  agent:
    fields:
      id: {}
      name: {}
      type: {}
      version: {}
      groups: {}
      key: {}
      last_login: {}
      is_connected: {}
  host:
    fields:
      ip: {}
      os:
        fields:
          full: {}
---
---
- name: agent
  title: Wazuh Agents
  short: Wazuh Inc. custom fields.
  type: group
  group: 2
  fields:
    - name: groups
      type: keyword
      level: custom
      description: >
        The groups the agent belongs to.
    - name: key
      type: keyword
      level: custom
      description: >
        The agent's registration key.
    - name: last_login
      type: date
      level: custom
      description: >
        The agent's last login.
    - name: is_connected
      type: boolean
      level: custom
      description: >
        Agents' interpreted connection status depending on `agent.last_login`.

Index settings

{
  "index_patterns": ["wazuh-agents*"],
  "priority": 1,
  "template": {
    "settings": {
      "index": {
        "number_of_shards": "1",
        "number_of_replicas": "0",
        "refresh_interval": "5s",
        "query.default_field": [
          "agent.id",
          "agent.groups",
          "agent.name",
          "agent.type",
          "agent.version",
          "agent.name",
          "host.os.full",
          "host.ip"
        ]
      }
    }
  }
}