Skip to content
share

Fleet Overview

Fleet provides a centralized view of all the Sematext Agents installed throughout your infrastructure, offering several key advantages:

  • List all hosts with installed Sematext Agents to get an overall view of your infrastructure, and easily switch between live and offline hosts
  • Get valuable info from each host, including host diagnostics, metrics, logs and events
  • Monitor the health status of each agent and check for available updates
  • Access a list of discovered services per host, which can be further configured in Discovery

Fleet Screen

At first glance, you can see the following data in the table:

  • Host: Names of hosts where the Sematext Agent is installed and running. You can either click on the name to open the Agent Information Panel or click on the expand view to reveal the list of discovered services running on the specific host. For further details, refer to the individual sections below.
  • Version: Installed version of the Sematext Agent and whether important updates are available. If they are, you can update the agent by just clicking the link and following the instructions. You can also find those instructions here.
  • Status: Indicates the status of the Sematext Agent. Possible statuses are:
    • Running: Everything is nominal.
    • Stopped: The agent has been stopped by the user. You can manually restart the Sematext Agent.
    • Failed: The agent is reporting errors. You can see them in the Agent Information Panel, in the Errors tab.
    • Dead: The agent has stopped due to an error. You can see the errors in the Agent Information Panel, in the Errors tab, and you can manually restart the Sematext Agent.
    • Pending or Unknown: the agent is not sending data to Sematext Cloud. Check if the agent is still running on your system. If it is, there may be connection issues.
  • Started: Time elapsed since the Sematext Agent began sending data to Sematext Cloud.
  • Infra App: the Infra App which is receiving the data from the Sematext Agent. Clicking on the App name will navigate you to the overview of the corresponding App in the Infrastructure section of Sematext Cloud.

Agent Information Panel

Info

The Info panel contains information about the host system and the installed Agents.

If the Agents are installed in a Kubernetes environment, you will see information about the Kubernetes environment, like Namespace and Node. If, however, the Agents are installed in a baremetal environment, this panel will show information related to the Agent process, like the Pid.

You can also find a link to the Infra App the Agent is associated with.

Agent Info

Log Agents

This panel contains a list of the Log Shippers installed on the host. If you click on one, it will take you to the Log Shipper panel, where you will find information about the Log Shipper version and type, the files and containers it's collecting logs from, as well as any errors. You can also see diagnostics data and report a problem from the Diagnostics tab.

Log Agents

The following status values are currently available for Log Shippers:

  • Running: The Log Shipper is running without issues
  • Not Configured: This is the initial state of Log Shipper. Potential causes:
    • Log Shipper has not been configured yet in Discovery, or another Log Shipper has been used to ship logs. Make sure to review the configuration of Log Shipper in Discovery.
    • If you are working in a Kubernetes environment, it may indicate issues with the permissions within a namespace or across the cluster. Check the Agent installation instructions to ensure that RBAC rules are set, and verify that all Kubernetes permissions have been properly configured.
  • Dead: The Sematext Agent started the Log Shipper but something went wrong. Usually, this means that the Log Shipper process is not available (bare metal), or the status of the Log Shipper container/pod is not running. You can manually restart the Sematext Agent
  • Init Failure: Systemd is not available (bare metal), there is an error pulling the Log Shipper container image, or there is an issue creating/starting the Log Shipper container/pod. Ensure that your system has enough resources to run the container/pod and confirm that you don't have issues with network connectivity to pull container images
  • Stopped: The Log Shipper process has been stopped by the Sematext Agent. You can manually restart the Sematext Agent

Metrics Agents

This panel contains a list of the Metrics Agents installed on the host. Clicking on one will take you to the Monitoring Agents panel, where you can see the process or container being monitored, the destination Monitoring App and its corresponding Infra App, service data such as sockets, ports and the command used to start the service, as well as any errors. You can also see diagnostics data and report a problem from the last tab.

Metrics Agents

Agent Errors

Here, you will find any errors that appear in the Sematext Agent's own logs. The severity field will always be error, and they'll include a timestamp and a message. You can find troubleshooting information here. You can find information about diagnostics in the Diagnostics Tab.

Agent Errors

Diagnostics

If you are having issues sending data from your host, in this tab you can find the most recent logs from the agent, as well as some of what's inside the configuration files. You can find our Agent Troubleshooting documentation here. If you need any help troubleshooting, you can click on the Report a Problem button, write a short description of your issue and our support team will receive the message alongside a copy of the diagnostics data.

Remember you can always contact us via chat on the bottom right corner of our webpage and the Help button on Sematext Cloud, or via email at support@sematext.com.

Agent Diagnostics

Upgrade Instructions

In this tab you'll find information on how to upgrade the Sematext Agent to the latest version for all supported environments.

Agent Info

Discovered Services

Here, you can find all the discovered services and logs for a specific host, including an overall view of the number of hosts where these services are available, monitored, and log shipping has been configured. You can use the eye icons to navigate to either the discovered services or logs.

Fleet Expanded