Try it free

Get a PMI process

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026
  • Early Access

Retrieve details for a Java process available for PMI metric collection in Dynatrace with the Extensions 2.0 API, using the process ID and optional filter.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/extensions/v2/discovery/pmi/processes/{process-id}

Overview

You provide the process-id path parameter to select a discovered Java process and can use the filter query parameter to refine the result. The operation returns a success response with the process details.

Authentication

To execute this request, you need a platform token or OAuth access token with extensions:discovery.pmi:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
process-idstring

Id of the Java process discovered in the environment for PMI metric collection.

pathRequired
filterstring

The filter parameter, as explained here.

Filtering is supported on the following field:

  • hostId - the ID of the host the process is running on, in the form HOST-XXXXXXXXXXXXXXXX.

If the parameter is omitted, all processes are returned.

Example: hostId = 'HOST-1234ABCD5678EFAB'

queryOptional

Response

Response codes

CodeTypeDescription
200PmiProcessDetails

Success.

404ErrorEnvelope

Failed. Agent data isn't yet available. Try again in a few seconds.

504ErrorEnvelope

Failed. Agent communication timeout.

4XXErrorEnvelope

Client error.

5XXErrorEnvelope

Server error.

Response body objects

The PmiProcessDetails object

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
codeinteger

The HTTP status code.

detailsErrorDetails

The error details.

messagestring

The error message.

The ErrorDetails object

The error details.

ElementTypeDescription
constraintViolationsConstraintViolation[]

A list of constraint violations.

The ConstraintViolation object

A list of constraint violations.

ElementTypeDescription
locationstring-
messagestring-
parameterLocationstring-
The element can hold these values
  • HEADER
  • PATH
  • PAYLOAD_BODY
  • QUERY
pathstring-

Response body JSON models

{
"WebSphere": {
"statistics": [
{
"name": "requestCount",
"type": "CountStatistic"
},
{
"name": "responseTime",
"type": "TimeStatistic"
}
],
"modules": [
"server1/applications/MyApp",
"server1/applications/OtherApp"
]
}
}
{
"error": {
"code": 404,
"message": "Pmi process information is not yet available from agent: 12345678901234567"
}
}
Related tags
Platform APIDynatrace PlatformInfrastructure Observability