How do I fetch the list of monitored process groups?

A call to the /infrastructure/process-groups endpoint returns a list of currently monitored process groups along with their attributes and relationships.

Process groups endpoint

https://{id}.live.dynatrace.com/api/v1/entity/infrastructure/process-groups

HTTP GET parameters

The endpoint allows the following parameters to be sent as HTTP GET requests:

  1. tag (optional) Filters the resulting set of process-groups by the given tag. Use multiple tag parameters to combine multiple tag filters using the logical operator AND. In case of key-value tags, such as imported AWS or CloudFoundry tags use following format: [context]key:value. An example for a complex tag could be: [AWS]Category:Demo.
  2. startTimestamp and endTimestamp (optional) Filters the resulting set of process-groups by the last seen timestamp. The timestamp values must be in UTC milliseconds and the query is restricted to a maximum period of 3 days.

Result

  • fromRelationships: Outgoing connections from the process-group to other entities.
  • toRelationships: Incoming relations to the process-group.
  • tags: Returns the list of tags that have been defined for the host. This list contains all user-defined labels as well as all tags imported from third-party systems, such as AWS.
  • metadata: Shows available metadata of the process-group.
  • softwareTechnologies: Shows the software technologies that were detected for that specific process-group.

The following code block shows an example result:

[
  {
    entityId: "PROCESS_GROUP-10D9583B735B6E4F",
    displayName: "Antimalware Service Executable",
    fromRelationships: {
      runsOn: [
        "HOST-19E86928A0CD2E35"
      ]
    },
    toRelationships: { },
    idCalcInputProps: {
      executablePaths: "C:\PROGRAM FILES\WINDOWS DEFENDER\MSMPENG.EXE"
    }
  },
  {
    entityId: "PROCESS_GROUP-8756C073DC6AD495",
    displayName: "Apache Web Server apache",
    tags: [
      {
        context: "USER",
        key: "karo"
      }
    ],
    fromRelationships: {
      runsOn: [
        "HOST-D70EC6885E79D6C4"
      ]
    },
    toRelationships: {
      runsOn: [
        "SERVICE-412D72DCEAFE79DE"
      ]
    },
    metadata: {
      dockerContainerImageNames: "docker.dynatrace.vmta:5000/php-joomla",
      apacheConfigPaths: "/etc/apache*/apache*.conf"
    },
    softwareTechnologies: [
      {
        type: "APACHE_HTTPD",
        version: "2.4.7"
      }
    ]
  }
]