Quickstart: Monitor your Kubernetes cluster with Elastic Agent

edit

Quickstart: Monitor your Kubernetes cluster with Elastic Agent

edit

In this quickstart guide, you’ll learn how to create the Kubernetes resources that are required to monitor your cluster infrastructure.

This new approach requires minimal configuration and provides you with an easy setup to monitor your infrastructure. You no longer need to download, install, or configure the Elastic Agent, everything happens automatically when you run the kubectl command.

The kubectl command installs the standalone Elastic Agent in your Kubernetes cluster, downloads all the Kubernetes resources needed to collect metrics from the cluster, and sends it to Elastic.

Prerequisites

edit
  • An Elasticsearch cluster for storing and searching your data, and Kibana for visualizing and managing your data. This quickstart is available for all Elastic deployment models. To get started quickly, try out our hosted Elasticsearch Service on Elastic Cloud.
  • A user with the superuser built-in role or the privileges required to onboard data.

    Expand to view required privileges
    • Cluster: ['monitor', 'manage_own_api_key']
    • Index: { names: ['logs-*-*', 'metrics-*-*'], privileges: ['auto_configure', 'create_doc'] }
    • Kibana: { spaces: ['*'], feature: { fleet: ['all'], fleetv2: ['all'] } }
  • A running Kubernetes cluster.
  • Kubectl.

Collect your data

edit
  1. In Kibana, go to the Observability UI and click Add Data.
  2. Under What do you want to monitor? select Kubernetes, and then select Elastic Agent: Logs & Metrics.

    Kubernetes entry point
  3. To install the Elastic Agent on your host, copy and run the install command.

    You will use the kubectl command to download a manifest file, inject user’s API key generated by Kibana, and create the Kubernetes resources.

  4. Go back to the Add Observability Data page.

    There might be a slight delay before data is ingested. When ready, you will see the message We are monitoring your cluster.

  5. Click Explore Kubernetes cluster to navigate to dashboards and explore your data.

Visualize your data

edit

After installation is complete and all relevant data is flowing into Elastic, the Visualize your data section allows you to access the Kubernetes Cluster Overview dashboard that can be used to monitor the health of the cluster.

Kubernetes overview dashboard

Furthermore, you can access other useful prebuilt dashboards for monitoring Kubernetes resources, for example running pods per namespace, as well as the resources they consume, like CPU and memory.

Refer to What is Elastic Observability? for a description of other useful features.