Configure OMS Linux Agent Heartbeat Interval

As you know both OMS Linux and Windows agent send heartbeat events and they are free of charge. The problem is that the interval of these heartbeat events is different for both operating systems. For Windows it is every 1 minute and for Linux is every 5 minutes. I do not know exactly the reason for this decision but I prefer that all my servers report at the same interval. The beautiful thing with the OMS Linux agent that is extendable and configurable. So this blog post will focus on how you can easily change the heartbeat interval on OMS Linux agent to 1 minute.

  • Login to your distro via SSH.
  • Make sure that you know the Workspace ID to which your Linux agents are connected.
  • Execute the command below by replacing the ID with your own. You can use your favorite editor if you want.
sudo vi /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/monitor.conf
  • After that you will need to change the following configuration from:
  type oms_heartbeat
  interval 5m


  type oms_heartbeat
  interval 1m
  • Insert key is used to go into editing mode and Esc key us used for entering into command mode. Executing :qw in command mode saves the configuraiton.
  • After that you only need to restart the OMS agent service:
sudo /opt/microsoft/omsagent/bin/service_control restart
  • You will start to see that the linux agents now report heartbeat every minute instead of every 5 minutes

Keep in mind that I am not aware if this change is supported or not but I would strongly advise you to not decrease the value below 1 minute.

4 thoughts on “Configure OMS Linux Agent Heartbeat Interval

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.