Skip to content

Sematext Core Infrastructure Monitoring

Sematext Monitoring provides complete insight into your infrastructure:

  • applications
  • servers
  • containers
  • processes
  • inventory
  • events, etc.

The centerpiece is an Infra App which acts as a container for all data about your infrastructure. As with other App types, you can create as many Infra Apps under your account as you wish.

Each Infra App is typically used to gather data from one environment. For example, one Infra App for production environment, one for test environment and one for development environment.

Sematext Cloud will automatically create one Infra App named "Default Infra App" the first time you might need it. You can also create Infra App on your own under Integrations -> Overview.

How it works

A Golang-based Sematext Agent will be installed on your machine. This Agent sends all infrastructure data to an Infra App whose token is configured during the Agent's installation.

The Infra App also includes data about your containerized environments. Installation instructions for container monitoring include an Infra App token. That way when installing Sematext Agent, an Infra App will be installed as well.

Enabling Infra Monitoring

If you've set up Sematext Monitoring at some point in the past, you can easily enable Infra Monitoring by:

  • Upgrading your sematext-agent to the latest version
  • Setting up Infra App token on each of your machines by running the setup-infra command

Note: For Docker monitoring, we suggest uninstalling the existing deprecated Agent and going through the new setup steps for Docker Monitoring in Sematext Cloud.

When doing a clean installation, regardless of whether you're installing in containerized environment or not, follow monitor installation instructions displayed in Sematext Cloud. Those instructions will always include everything needed to set up an Infra App, either on its own or alongside some other App Agent.

The setup-infra command

Setting up or changing which Infra App should receive infrastructure data and metrics from a particular machine can be done with the setup-infra command.

To see which Infra Apps exist in your account visit Sematext Cloud -> Integrations -> Apps. You can choose any of the existing Infra Apps or create a new one.

Once you do that you'll have the token of that particular App. To set up the token run the following command on each machine that you wish to update:

sudo bash /opt/spm/bin/setup-infra --infra-token YOUR_INFRA_APP_TOKEN_HERE

Create an Infra App

Creating a new Infra App is the same process as with any App in Sematext. In the Integrations view you choose Infra App, give it a name and click continue.

This screen shows installation instructions which you'll have to follow to start using the Infra App. Select the operating system running on your machines and run the simple setup commands.

Infra App Metrics

Metrics will start shipping to your new Infra App in a few moments.


Infrastructure Monitoring provides: