Site24x7 APM Insight Java 代理 – Ansible 角色

概述

您可以使用 Ansible 角色在应用服务器上批量安装 Site24x7 APM Insight Java 代理。它支持常见的应用服务器和框架，例如 Apache Tomcat、JBoss、Oracle WebLogic 和 WildFly。

系统要求

• 目标主机上必须存在 unzip 命令。
• 支持的操作系统包括 RedHat、Rocky、AlmaLinux、Debian 和 Darwin。
• 控制节点上需已安装 Ansible。Ansible 安装指南。

配置

可在 Site24x7 APM Insight Ansible 角色中配置以下属性，以启用应用性能监控。

APM Insight 配置属性

可通过 apminsight_props 变量指定这些设置，以定义应用监控的核心配置。

角色安装属性

这些属性定义了将 Site24x7 APM Insight 代理与 Web 服务器集成所需的服务器专属配置。

使用 Ansible 安装 Site24x7 APM Insight Java 代理

按照以下步骤，使用 Ansible 角色在应用服务器上配置 Site24x7 APM Insight Java 代理。

步骤 1：解压并配置角色

1. 使用以下命令解压 Ansible 角色并将其重命名为 Site24x7-APM：

curl -L -o Site24x7-APM-Ansible-main.zip https://github.com/site24x7/Site24x7-APM-Ansible/archive/refs/heads/main.zip && unzip Site24x7-APM-Ansible-main.zip && mv Site24x7-APM-Ansible-main Site24x7-APM

2. 使用上述命令解压 zip 文件后，包含 my-playbook.yml 和 my-inventory.yml 文件的最终文件夹结构如下所示：

   ├─ Site24x7-APM
   ├    ├── defaults
   ├    ├── handlers
   ├    ├── meta
   ├    ├── tasks
   ├    ├── tests
   ├    ├── vars
   ├    ├── README.md
   ├─ my-playbook.yml
   ├─ my-inventory.yml

步骤 2：配置清单文件和 playbook

1. 按如下方式创建清单文件。

   my-inventory.yml 文件示例：

   prod_webserver:
     vars:
       ansible_user: fedora
       ansible_password: <Your Host Password>
       ansible_sudo_pass: <Your Sudo Password>
       server_type: tomcat
     hosts:
       java_server_one:
         ansible_host: 10.0.20.5
         java_agent_host_config:
           app_name: Example App
       java_server_two:
         ansible_host: 127.0.40.2

2. 按如下方式创建 playbook 文件。
   

   my-playbook.yml 文件示例：

   - hosts: prod_webserver
     vars:
       apminsight_props:
         app_name: <Your Application Name>
         license_key: <Your License Key>
       install_props:
         server_type: 'tomcat'
         jvm_config_file: '/usr/share/tomcat8/bin/setenv.sh'
         service_name: 'tomcat'
         server_version: '8'
         restart_web_server: true
     tasks:
      - include_role:
          name: Site24x7-APM

步骤 3：安装代理

1. 使用以下命令运行 Ansible playbook：

   ansible-playbook -i ./my-inventory.yml ./my-playbook.yml

2. 验证代理已安装且应用服务器正常运行。

卸载

要使用 Ansible 卸载 Site24x7 APM Insight Java 代理，可在 Ansible playbook 中使用以下变量属性：

Ansible playbook 示例

以下是卸载 Site24x7 APM Insight Java 代理的 Ansible playbook 示例：

uninstall-playbook.yml 文件示例：

- hosts: webservers
  vars:
    uninstall: true
    ansible_sudo_pass: <Your Sudo Password>
  tasks:
   - include_role:
       name: Site24x7-APM

执行以下命令以运行卸载 playbook。

ansible-playbook -i ./my-inventory.yml ./uninstall-playbook.yml