caapm/apmia

CA APM Infrastructure Agent Docker镜像文档

概述

CA APM Infrastructure Agent (IA) Docker镜像允许在Swarm、Kubernetes等Docker编排平台上安装配置Infrastructure Agent。支持通过环境变量传递IntroscopeAgent.profile、Extensions.profile或单个扩展的bundle.profile配置，方法为在配置属性前添加“APMENV_”，并将句点“.”替换为下划线“_”，环境变量键不区分大小写（最佳实践为大写）。例如agentManager.url.1对应APMENV_AGENTMANAGER_URL_1。

前置条件

应用镜像前需满足以下条件：

1. 镜像名称：确定CA APM IA Docker镜像名称。
2. 编排平台：明确部署环境（Swarm、Kubernetes、Openshift或独立Docker）。
3. 扩展部署：通过APMENV_INTROSCOPE_AGENT_EXTENSIONS_BUNDLES_LOAD环境变量指定扩展，值为逗号分隔的区分大小写列表。
4. 部署模式：选择单节点部署（如Swarm的Service、Kubernetes的Deployment）或集群所有节点部署（如Swarm全局模式、Kubernetes DaemonSet）。
5. 配置参考：参考不同平台的AWS和Azure扩展配置示例。

支持的标签

标签内容

25.10.1.12

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes/25-10-1.html#GUID-0f965c61-2e08-4af4-a479-4896919af5ea-en_Mainframe

25.9.1.12

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-operational-observability/saas/release-notes/2591-release-notes.html

25.8.2.11

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes/25-8-2.html#GUID-45564645-ddaf-4c00-ad51-e1a08a9f9b67-en_InfrastructureAgent

25.8.1.7

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes/25-8-1.html#_18ff67e8-877d-44ec-8117-13cd4cae9980_InfrastructureAgent

25.7.1.21

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes/25-7-1.html#_3f324e16-30a1-4a9b-a005-d923e0905e58_InfrastructureAgent

25.5.2.9

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes/25-5-2.html#_7512279d-ae93-43a0-82b1-af2fa0d1f4b8_InfrastructureAgent

25.5.1.11

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes/25-5-1.html#_2ea96cef-5d36-4199-b54b-a01146fe17c6_InfrastructureAgent

25.4.2.5

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes/25-4-2.html#_64418afd-e0c2-4967-8dbd-376215a85ed9_InfrastructureAgent

25.4.1.14

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes/25-4-1.html#_5af6759c-6f46-4eb6-81c3-b3f439f5802f_InfrastructureAgent

25.2.1.25

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes.html

25.1.1.26

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes/25-1-1.html#_601be3cc-b776-49af-a32e-5d247b7100fc_InfrastructureAgent

24.10.1.5

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes/24-10-1.html#_55e82707-0189-4ca7-a3fc-8ae4e07d77ad_InfrastructureAgentEnhancements

24.9.1.19

• https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-agents/SaaS/release-notes/24-9-1.html#_181f97ad-752f-42ea-90df-d631040f946d_InfrastructureAgentEnhancements

安装说明

注意

[AGENTMANAGER_URL]：Agent/EM连接详情与IntroscopeAgent.profile中提供的类似。

Swarm/UCP

部署命令：

bash
docker stack deploy -c install.yml apmiamonitor --with-registry-auth

Standalone

启动命令：

bash
docker-compose -f install.yml up -d

install.yml配置示例（AWS扩展）

yaml
version: "3"
services:
  apmia:
    image: docker.xuanyuan.run/caapm/apmia:latest
    environment:
      - APMENV_AGENTMANAGER_URL_1=[AGENTMANAGER_URL]
      - APMENV_AGENTMANAGER_CREDENTIAL=[AGENTMANAGER_CREDENTIAL]
      - APMENV_INTROSCOPE_AGENT_EXTENSIONS_BUNDLES_LOAD=AWSExtension
      - APMENV_COM_CA_APM_AGENT_AWS_ACCESSKEY=<accesskey>
      - APMENV_COM_CA_APM_AGENT_AWS_SECRETKEY=<secretkey>
    deploy:
      resources:
        limits:
          cpus: '0.7'
          memory: 700M

install.yml配置示例（Azure扩展）

yaml
version: "3"
services:
  apmia:
    image: docker.xuanyuan.run/caapm/apmia:latest
    environment:
      - APMENV_AGENTMANAGER_URL_1=[AGENTMANAGER_URL]
      - APMENV_AGENTMANAGER_CREDENTIAL=[AGENTMANAGER_CREDENTIAL]
      - APMENV_INTROSCOPE_AGENT_EXTENSIONS_BUNDLES_LOAD=AzureMonitor
      - APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_USERNAME=<value>
      - APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_SUBSCRIPTIONID=<value>
      - APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_CLIENTID=<value>
      - APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_TENANTID=<value>
      - APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_CLIENTSECRET=<value>
    deploy:
      resources:
        limits:
          cpus: '0.7'
          memory: 700M

Kubernetes

安装命令：

bash
kubectl create -f install.yml

卸载命令：

bash
kubectl delete -f install.yml

install.yml配置示例（AWS扩展）

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: apmia-aws
  labels:
    tier: monitoring
    app: caagent_apmia
    version: v1
spec:
  template:
    metadata:
      labels:
        app: caagent_apmia
    spec:
      containers: