Sign inSign up

caapm/apmia

By caapm

•Updated 27 days ago

CA APM Infrastructure Agent as Docker Image

Image
Monitoring & observability
2

100K+

caapm/apmia repository overview

⁠CA APM Infrastructure Agent as Docker Image

CA APM Infrastructure Agent (IA) can be installed and configured from a docker image on any docker orchestration platform, such as Swarm or Kubernetes. You can now pass any configuration for the IntroscopeAgent.profile, Extensions.profile, or bundle.profile of an individual extensions using the environment variable. You must append "APMENV_" before the profile properties and replace all period "." characters with underscore "_" characters to obtain the key of its equivalent environment variable. The environment variable key that is created is not case sensative. For example, to pass agentManager.url.1 as an environment variable, the key is APMENV_agentManager_url_1 or APMENV_AGENTMANAGER_URL_1. As a best practice, pass all the environment variables as uppercase.

⁠Prerequisites Before Applying the Image
  1. Image name: Identify the CA APM IA docker image name.
  2. Standalone Docker Platform: Identify the orchestration platform. For example, do you want to install the image on Swarm, Kubernetes, or Openshift? Do you want to install the image on a Standalone Docker setup?
  3. APM IA extensions to be deployed: Pass the names of the extensions in the APMENV_INTROSCOPE_AGENT_EXTENSIONS_BUNDLES_LOAD environment variable. The value of this property is a comma-separated list that is case sensative.
  4. Deployment Mode: Identify if you need to install the image on one node in the cluster (for example, Service for Swarm , Deployment for Kubernetes, or DeploymentConfig for Openshift) or all nodes in the cluster (for example, global mode deployment for Swarm and DaemonSet deployment for Kubernetes/Openshift).
  5. Review the following samples to configuge AWS and Azure extensions on different platforms.
⁠Supported Tags
TagsDateSupported APM VersionRelease Notes
latest29-Aug-2026DX Operational Observability, 10.7 SP2 +26.8.2 Release Notes⁠
26.8.2.1629-Aug-2026DX Operational Observability, 10.7 SP2 +26.8.2 Release Notes⁠
26.8.1.1710-Aug-2026DX Operational Observability, 10.7 SP2 +26.8.1 Release Notes⁠
26.7.1.1812-Jul-2026DX Operational Observability, 10.7 SP2 +26.7.1 Release Notes⁠
26.6.1.2412-Jun-2026DX Operational Observability, 10.7 SP2 +26.5.1 Release Notes⁠
26.5.1.1131-May-2026DX Operational Observability, 10.7 SP2 +26.5.1 Release Notes⁠
26.4.1.254-May-2026DX Operational Observability, 10.7 SP2 +26.4.1 Release Notes⁠
26.3.1.231-Mar-2026DX Operational Observability, 10.7 SP2 +26.3.1 Release Notes⁠
26.1.1.353-Feb-2026DX Operational Observability, 10.7 SP2 +26.1.1 Release Notes⁠
25.11.1.3813-Nov-2025DX Operational Observability, 10.7 SP2 +25.11.1 Release Notes⁠
25.10.1.1213-Oct-2025DX Operational Observability, 10.7 SP2 +25.10.1 Release Notes⁠
25.9.1.1225-Sep-2025DX Operational Observability, 10.7 SP2 +25.9.1 Release Notes⁠
25.8.2.119-Sep-2025DX Operational Observability, 10.7 SP2 +25.8.2 Release Notes⁠
25.8.1.75-Aug-2025DX Operational Observability, 10.7 SP2 +25.8.1 Release Notes⁠
25.7.1.217-Jul-2025DX Operational Observability, 10.7 SP2 +25.7.1 Release Notes⁠
25.5.2.923-May-2025DX Operational Observability, 10.7 SP2 +25.5.2 Release Notes⁠
25.5.1.1105-May-2025DX Operational Observability, 10.7 SP2 +25.5.1 Release Notes⁠
25.4.2.522-Apr-2025DX Operational Observability, 10.7 SP2 +25.4.2 Release Notes⁠
⁠Tag content

26.8.2.16

26.8.1.17

26.7.1.18

26.6.1.25

26.5.1.11

26.4.1.25

26.3.1.2

26.1.1.35

25.11.1.38

25.10.1.12

25.9.1.12

25.8.2.11

25.8.1.7

25.7.1.21

25.5.2.9

25.5.1.11

25.4.2.5

⁠Installation
⁠Note: [AGENTMANAGER_URL]: The Agent/EM Connection details are similar to those provided on the IntroscopeAgent.profile.
⁠Swarm/UCP

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

⁠Standalone

docker-compose -f install.yml up -d

⁠Content of install.yml for AWS extension
version: "3"
services:
  apmia:
    image : 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
⁠Content of install.yml for Azure extension
version: "3"
services:
  apmia:
    image : 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
⁠Install command :kubectl create -f install.yml
⁠Uninstall command :kubectl delete -f install.yml
⁠Content of install.yml for AWS extension
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:
        - resources:
          env:
            - name: APMENV_AGENTMANAGER_URL_1
              value: [AGENTMANAGER_URL]
            - name: APMENV_AGENTMANAGER_CREDENTIAL
              value: [AGENTMANAGER_CREDENTIAL]
            - name: APMENV_COM_CA_APM_AGENT_AWS_ACCESSKEY
              value: <accesskey>
            - name: APMENV_COM_CA_APM_AGENT_AWS_SECRETKEY
              value: <secretkey>
            - name: APMENV_INTROSCOPE_AGENT_EXTENSIONS_BUNDLES_LOAD
              value: AWSExtension

          name: apmia
          image: caapm/apmia:latest
          imagePullPolicy: Always
          resources:
            limits:
              cpu: "0.7"
              memory: 700M
⁠Content of install.yml for Azure extension
apiVersion: apps/v1
kind: Deployment
metadata:
  name: apmia
  labels:
    tier: monitoring
    app: caagent_apmia
    version: v1

spec:
  template:
    metadata:
      labels:
        app: caagent_apmia
    spec:
      containers:
        - resources:
          env:
            - name: APMENV_AGENTMANAGER_URL_1
              value: [AGENTMANAGER_URL]
            - name: APMENV_AGENTMANAGER_CREDENTIAL
              value: [AGENTMANAGER_CREDENTIAL]
            - name: APMENV_INTROSCOPE_AGENT_EXTENSIONS_BUNDLES_LOAD
              value: AzureMonitor
            - name: APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_USERNAME
              value: <value>
            - name: APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_SUBSCRIPTIONID
              value: <value>
            - name: APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_CLIENTID
              value: <value>
            - name: APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_TENANTID
              value: <value>
            - name: APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_CLIENTSECRET
              value: <value>
          name: apmia
          image: caapm/apmia:latest
          imagePullPolicy: Always
          resources:
            limits:
              cpu: "0.7"
              memory: 700M
⁠Openshift
⁠Install command :oc create -f install.yml
⁠Uninstall command :oc delete -f install.yml
⁠Content of install.yml for AWS extension
apiVersion: apps/v1
kind: Deployment
metadata:
  name: apmia-aws
  labels:
    tier: monitoring
    app: caagent_apmia
    version: v1
spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: caagent_apmia
    spec:
      containers:
        - resources:
          env:
            - name: APMENV_AGENTMANAGER_URL_1
              value: [AGENTMANAGER_URL]
            - name: APMENV_AGENTMANAGER_CREDENTIAL
              value: [AGENTMANAGER_CREDENTIAL]
            - name: APMENV_COM_CA_APM_AGENT_AWS_ACCESSKEY
              value: <accesskey>
            - name: APMENV_COM_CA_APM_AGENT_AWS_SECRETKEY
              value: <secretkey>
            - name: APMENV_INTROSCOPE_AGENT_EXTENSIONS_BUNDLES_LOAD
              value: AWSExtension

          name: apmia
          image: caapm/apmia:latest
          imagePullPolicy: Always
          resources:
            limits:
              cpu: "0.7"
              memory: 700M
⁠Content of install.yml for Azure extension
apiVersion: apps/v1
kind: Deployment
metadata:
  name: apmia-azure
  labels:
    tier: monitoring
    app: caagent_apmia
    version: v1

spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: caagent_apmia
    spec:
      containers:
        - resources:

          env:
            - name: APMENV_AGENTMANAGER_URL_1
              value: <AGENTMANAGER_URL>
            - name: APMENV_AGENTMANAGER_CREDENTIAL
              value: [AGENTMANAGER_CREDENTIAL]
            - name: APMENV_INTROSCOPE_AGENT_EXTENSIONS_BUNDLES_LOAD
              value: AzureMonitor
            - name: APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_USERNAME
              value: <value>
            - name: APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_SUBSCRIPTIONID
              value: <value>
            - name: APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_CLIENTID
              value: <value>
            - name: APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_TENANTID
              value: <value>
            - name: APMENV_INTROSCOPE_AGENT_AZURE_MONITOR_RESOURCE_LOGINS_DEFAULT_CLIENTSECRET
              value: <value>

          name: apmia
          image: caapm/apmia:latest
          imagePullPolicy: Always
          resources:
            limits:
              cpu: "0.7"
              memory: 700M

Tag summary

Content type

Image

Digest

sha256:9e88ae587…

Size

1.8 GB

Last updated

27 days ago

docker pull caapm/apmia