search

microsoft / OMS-Agent-for-Linux

http://www.microsoft.com/oms
Other
411 stars 308 forks source link

readme

[DEPRECATED] Operations Management Suite Agent for Linux

:warning: The Log Analytics agent has been deprecated and has no support as of August 31, 2024. If you use the Log Analytics agent to ingest data to Azure Monitor, migrate now to the new Azure Monitor agent.

Overview

Welcome to the Log Analytics agent for Linux! The 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

The following steps configure setup of the Log Analytics agent in Azure and Azure Government cloud. Commands are for 64-bit. Before installing the Log Analytics agent for Linux, you need the workspace ID and key for your Azure Monitor Log Analytics workspace.

  1. In the Azure portal, click All services found in the upper left-hand corner. In the list of resources, type Log Analytics Workspace. As you begin typing, the list filters based on your input. Select Log Analytics Workspace.
  2. In your list of Log Analytics workspaces, select the workspace.
  3. Select Agents Management from the left hand pane.
  4. Select the Linux Servers tab.
  5. There is a dropdown chevron next to Log Analytics agent instructions. Click it.
  6. Copy and paste into your favorite editor the value to the right of Workspace ID and Primary Key.

To configure the Linux computer to connect to an Azure Monitor Log Analytics workspace, run the following command providing the workspace ID and primary key copied earlier. The following command downloads the agent, validates its checksum, and installs it.

For Azure Monitor Log Analytics workspace in commercial cloud:

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

For Azure Monitor Log Analytics workspace in Azure Government cloud:

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

Azure Install guide

If you are an Azure customer, we have an Azure VM extension that allows you to easily onboard to Azure Monitor Log Analytics workspace.

Full installation guide

Download Latest OMS Agent for Linux (64-bit)

Download Latest OMS Agent for Linux (Final 32-bit Release)

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:

Supported Linux Operating Systems

Supported Distro/Version strategy

The Log Analytics agent for Linux is built to work with Azure Monitor logs, 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. Focus support on any of the Azure Linux Endorsed distros. Note that there may be some delay between a new distro/version being Azure Linux Endorsed and it being supported for the Log Analytics Linux agent.
  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. Only support VM images; containers, even those derived from official distro publishers' images, are not supported.
  6. Not support new versions of AMI.
  7. 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.

Pre-1.13.27 Python Requirements

64-bit

Note: Containers are not supported. If you need to monitor containers, please leverage the Container Monitoring solution for Docker hosts or Azure Monitor for containers for Kubernetes.

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

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

Troubleshooting Guide

Supported Scenarios

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.