OMS-Agent-for-Linux 项目启动和配置教程

OMS-Agent-for-Linux 项目启动和配置教程

OMS-Agent-for-Linux 项目地址: https://gitcode.com/gh_mirrors/om/OMS-Agent-for-Linux

1. 项目的目录结构及介绍

OMS-Agent-for-Linux 是微软开源的一个项目，用于在 Linux 系统上收集、分析和转发日志数据到 Azure Monitor Log Analytics。以下是项目的目录结构及各部分的简要介绍：

• .github/: 包含项目的 GitHub Actions 工作流文件，用于自动化构建、测试等流程。
• installer/: 包含安装脚本和安装过程中所需的文件。
• source/: 项目的源代码，包括主要的 Python 脚本和辅助文件。
• tools/: 包含一些辅助工具和脚本，用于开发和测试。
• .gitignore: 指定 Git 忽略的文件和目录。
• .gitmodules: 用于引用子模块的配置文件。
• CONTRIBUTING.md: 提供贡献代码的指南和规则。
• Dockerfile: 用于创建 Docker 容器的构建文件。
• LICENSE: 项目的许可文件，通常为 MIT 或 Apache 许可。
• README.md: 项目的自述文件，包含项目的描述、使用方法和安装指南。
• SECURITY.md: 提供安全相关的信息和指南。
• cgmanifest.json: 配置文件的清单文件。

2. 项目的启动文件介绍

项目的启动主要通过 installer/scripts/onboard_agent.sh 脚本进行。以下是启动文件的主要步骤：

1. 使用 wget 命令下载安装脚本。
2. 通过 sh 命令执行下载的安装脚本。
3. 安装脚本会要求用户输入 Azure Monitor Log Analytics 的工作区 ID 和主密钥。
4. 脚本会下载代理，验证其校验和，并安装到系统中。

对于商业云的工作区，命令如下：

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>

对于政府云的工作区，命令如下：

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

3. 项目的配置文件介绍

OMS-Agent-for-Linux 的配置主要通过修改 /etc/omsagent/omsagent.ini 文件进行。以下是配置文件的一些主要配置项：

• [omsagent] 部分：包含代理的基本配置，如工作区 ID、主密钥等。
• [inputs] 部分：定义了要收集的数据类型，如系统日志、性能数据等。
• [outputs] 部分：定义了数据的输出目的地，通常是 Azure Monitor Log Analytics。
• [processors] 部分：定义了数据在发送前进行的处理，如过滤、转换等。

确保正确配置这些设置，以便代理能够正确地收集和转发数据。

OMS-Agent-for-Linux 项目地址: https://gitcode.com/gh_mirrors/om/OMS-Agent-for-Linux