Switch branches/tags
Clone or download

README.md

Operations Management Suite Agent for Linux (2018-05)

Overview

Welcome to the OMS Agent for Linux! The OMS Agent for Linux enables rich and real-time analytics for operational data (Syslog, Performance, Alerts, Inventory) from Linux servers, Docker Containers and monitoring tools like Nagios, Zabbix and System Center.

Quick Install guide

Run the following commands to download the omsagent, validate the checksum, and install+onboard the agent. Commands are for 64-bit. The Workspace ID and Primary Key can be found inside the OMS Portal under Settings in the connected sources tab.

$> wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh -w <YOUR OMS WORKSPACE ID> -s <YOUR OMS WORKSPACE PRIMARY KEY>

Azure Install guide

If you are an Azure customer, we have an Azure VM Extension that allows you to onboard with a couple of clicks.

Full installation guide

Video Walkthrough

Download Latest OMS Agent for Linux (64-bit)

Download Latest OMS Agent for Linux (32-bit)

Feedback

We love feedback! Whether it be good, bad or indifferent, it really helps us build a better product for you. There are a few different routes to give feedback:

  • UserVoice: Post ideas for new OMS features to work on here
  • Monthly survey: if you are an OMS customer, you know we send out a survey every month asking our customers about the features we’re working on next.
  • Elite Linux customer panel: If you are a die-hard OMS Linux user and want to join our weekly calls and talk directly to the product team apply through this survey.

Supported Linux Operating Systems

Supported Distro/Version strategy

The OMS Agent for Linux is built to work with OMS, which has a limited scope of scenarios. Our strategy for supporting new distros and versions starting August 2018 is that we will:

  1. Only support server versions, no client OS versions.
  2. Always support any new (Azure Linux Endorsed distros/versions)[https://docs.microsoft.com/en-us/azure/virtual-machines/linux/endorsed-distros].
  3. Not support versions that have passed their manufacturer's end-of-support date.
  4. Always support the latest GA version of a supported distro.
  5. Not support new versions of AMI.
  6. Only support versions that run SSL 1.x by default.

If you are using a distro or version that is not currently supported and doesn't fit our future support strategy, we recommend that you fork this repo, acknowledging that Microsoft support will not provide assistance with for forked agent versions.

64-bit

  • CentOS 6 and 7
  • Amazon Linux 2017.09
  • Oracle Linux 6 and 7
  • Red Hat Enterprise Linux Server 6 and 7
  • Debian GNU/Linux 8 and 9
  • Ubuntu Linux 14.04 LTS, 16.04 LTS and 18.04 LTS
  • SUSE Linux Enteprise Server 12

32-bit

  • CentOS 6
  • Oracle Linux 6
  • Red Hat Enterprise Linux Server 6
  • Debian GNU/Linux 8 and 9
  • Ubuntu Linux 14.04 LTS and 16.04 LTS

Note: Openssl 1.1.0 is only supported on x86_64 platforms (64-bit).

Note: OpenSSL < 1.x is not supported on any platform.

Supported Scenarios

Heartbeat data collection

Syslog data collection

Docker collection

Performance data collection

Nagios Core alert collection

Zabbix alert collection

CollectD Metrics Collection

Custom JSON Data

VMware Monitoring

Full documentation

Troubleshooting Guide

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.