Skip to content

Agent Troubleshooting

If you are experiencing issues with the Sematext Agent, there are some things you can try.

  1. Check the Sematext Agent logs and filter by errors. By default they'll be located at /opt/spm/spm-monitor/logs/st-agent.
  2. If you see errors related to permission denied while accessing log files or system information, restart the agent with elevated privileges.
  3. If you see errors like "cloud" collector failed to complete the initial run check out our tags common schema docs and verify your IAM roles are set up correctly.

  4. Try restarting the agent. Specific instructions on how to do so depending on your environment can be found here.

  5. Update the agent to the latest version. For more details on how to do that, see our Agent Upgrade Instructions. You can see which agents need to be updated in the Fleet section of Sematext Cloud. Fleet If there is an update available for a particular agent, you'll see a warning next to the agent's version.

Find the full Fleet documentation here.

  1. If data cannot be shipped, you may be behind a proxy. If that's the case, follow these instructions to configure the agent.

  2. Journal is a buffer we use to store data when shipping fails. In case of outages or internal communication issues, the Journal files may grow rapidly and produce high system load. If you are experiencing high CPU usage, do the following:

  3. Navigate to the Journal directory, by default /opt/spm/spm-monitor/st-agent/journal.
  4. See if it contains a large number of files. If it does, it might be the cause of high CPU usage.

Disabling Journal may lower the CPU usage. However, data that fails to ship will be lost, so disabling Journal may lead to gaps in the data stored in Sematext Cloud. You can disable Journal by following these steps:

  1. Open the following file in your text editor: /opt/spm/properties/st-agent.yml.
  2. Comment out the journal section by adding the character # at the beginning of every line in the section.
  3. Restart the Sematext Agent. Note that this is a temporary solution, and you should contact our support team to help you identify and solve the root cause of your issue.

If you are still having trouble, you can send us the diagnostics package, and we will assist you as soon as possible. To do so:

  1. Go to your Sematext Cloud dashboard.
  2. On the menu on the left, select Fleet. Fleet screen
  3. Find your host on the list and click on it.
  4. Navigate to the Diagnostics tab. Fleet screen
  5. Click on Report a problem and describe your issue.
  6. Once you're done, click on Send a report and we will reply shortly.


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 Sematext Cloud Help