Oracle Cloud Infrastructure Documentation

Details for Application Performance Monitoring

Describes logging details for Application Performance Monitoring (APM).

Resources

  • Apm Domains

Log Categories

API value (ID): Console (Display Name) Description
dropped-data Dropped Data The incoming ingest requests that were rejected by the APM service because of throttling, invalid data keys, or an oversized or malformed payload. This information helps customers triage dropped requests.

Availability

Application Performance Monitoring logging is available in all the regions of the commercial realms.

Comments

Service logs for Application Performance Monitoring logging are delivered on a best effort basis. In limited situations, a few log entries might not be delivered successfully. Furthermore, the number of log messages per minute are limited.

Contents of an Application Performance Monitoring Log

Property Description
arrivaltime Timestamp when observation arrived, in the format of "2023-03-14T15:21:27.010Z".
content Original content of the observation. The display size limit is 4 KB.
contentlength Length of content in bytes.
dataformat Format name of the data, for example, "apm".
dataformatversion Format version.
message Human-readable string describing the rejection cause.
obstype Type of the observation, for example, "public-span".
rejectioncause Rejection cause, which can be one of the following:
  • PAYLOAD_THROTTLED
  • BAD_FORMAT
  • OVERSIZED_PAYLOAD
  • INVALID_DATA_KEY
compartmentid OCID of the compartment.
loggroupid OCID of the log group.
logid OCID of the log object.
tenantid OCID of the tenant.
id UUID of the log message.
source OCID of the APM domain.
specversion The version of the CloudEvents specification which the event uses. This enables the interpretation of the context.
time Timestamp when the log was written.
type The message type. Consumers use the type and specversion to determine how to interpret the body. Pattern: com.oraclecloud.{service}.{resource-type}.{category}, for example, com.oraclecloud.compute.instance.terminated.

Example Application Performance Monitoring Log

{
  "datetime": 1678807287324,
  "logContent": {
    "data": {
      "arrivaltime": "2023-03-14T15:21:27.010Z",
      "content": "{\\\"major-version\\\": 1, \\\"minor-version\\\": 0, \\\"payload-creation-ts-millis\\\": 1678807286000, \\\"resource\\\": {\\\"attributes\\\": [{\\\"key\\\": \\\"Component\\\", \\\"value\\\": \\\"BROWSER\\\"}, {\\\"key\\\": \\\"ServiceName\\\", \\\"value\\\": \\\"dogService\\\"}, {\\\"key\\\": \\\"ApmrumLanguage\\\", \\\"value\\\": \\\"en-US\\\"}, {\\\"key\\\": \\\"ApmrumWindowId\\\", \\\"value\\\": \\\"\\\"}, {\\\"key\\\": \\\"SessionId\\\", \\\"value\\\": \\\"session-dog1678807286000-3311688\\\"}, {\\\"key\\\": \\\"UserName\\\", \\\"value\\\": \\\"dogUser\\\"}]}, \\\"spans\\\": [{\\\"id\\\": \\\"dog1678807286000-3311688-2929311\\\", \\\"trace-id\\\": \\\"dog1678807286000-3311688\\\", \\\"name\\\": \\\"Page Load dogPage\\\", \\\"ts-micros\\\": 1678807284900000, \\\"td-micros\\\": 820619, \\\"kind\\\": \\\"PRODUCER\\\", \\\"attributes\\\": {\\\"ApmrumType\\\": \\\"Page\\\", \\\"WebApplicationName\\\": \\\"dogWebapp\\\", \\\"PageInitTime\\\": 870, \\\"PageFirstByteTime\\\": 412, \\\"PageDownloadTime\\\": 17, \\\"PageRenderTime\\\": 994, \\\"PageInteractiveTime\\\": 341, \\\"ApmrumPageUpdateType\\\": \\\"Page Load\\\", \\\"HttpUrl\\\": \\\"http://www.dogHost.com/dogIndex.html\\\", \\\"HttpUrlHost\\\": \\\"http://www.dogHost.com\\\", \\\"HttpUrlPath\\\": \\\"/dogIndex.html\\\", \\\"HttpStatusCode\\\": 200, \\\"Error\\\": false}, \\\"links\\\": []}, {\\\"id\\\": 5797336, \\\"trace-id\\\": \\\"dog1678807286000-3311688\\\", \\\"parent-id\\\": \\\"dog1678807286000-3311688-2929311\\\", \\\"name\\\": \\\"Page Load page-0\\\", \\\"ts-micros\\\": 1678807284900000, \\\"td-micros\\\": 990000, \\\"kind\\\": \\\"PRODUCER\\\", \\\"attributes\\\": {\\\"ApmrumType\\\": \\\"Page\\\", \\\"WebApplicationName\\\": \\\"dogWebapp\\\", \\\"PageInitTime\\\": 110, \\\"PageFirstByteTime\\\": 304, \\\"PageDownloadTime\\\": 5, \\\"PageRenderTime\\\": 732, \\\"PageInteractiveTime\\\": 401, \\\"ApmrumPageUpdateType\\\": \\\"Page Load\\\", \\\"HttpUrl\\\": \\\"http://www.dogHost.com/dogIndex.html\\\", \\\"HttpUrlHost\\\": \\\"http://www.dogHost.com\\\", \\\"HttpUrlPath\\\": \\\"/dogIndex.html\\\", \\\"HttpStatusCode\\\": 200, \\\"Error\\\": false}, \\\"links\\\": []}]}",
      "contentlength": "1616",
      "dataformat": "apm",
      "dataformatversion": "1",
      "message": "The request is rejected due to throttling limits.",
      "obstype": "public-span",
      "rejectioncause": "PAYLOAD_THROTTLED"
    },
    "id": "<unique_ID>",
    "oracle": {
      "compartmentid": "ocid1.compartment.oc1..<unique_ID>",
      "ingestedtime": "2023-03-14T15:21:35.427Z",
      "loggroupid": "ocid1.loggroup.oc1.phx.<unique_ID>",
      "logid": "ocid1.log.oc1.phx.<unique_ID>",
      "tenantid": "ocid1.tenancy.oc1..<unique_ID>"
    },
    "source": "ocid1.apmdomain.oc1.phx.<unique_ID>",
    "specversion": "1.0",
    "time": "2023-03-14T15:21:27.324Z",
    "type": "com.oraclecloud.apm.domain.dropped-data"
  }
}