Error Code Analysis Dashboard

You're viewing Apigee Edge documentation.
Go to the Apigee X documentation.
info

What does this dashboard tell me?

The Error Code Analysis dashboard tells you about error rates for API proxies and targets. The Error Code Analysis dashboard uses:

  • The response code to calculate proxy errors

  • The target response code to calculate target errors

Errors reported on the Error Code Analysis dashboard might be different from errors reported on the API Proxy Performance dashboard because that dashboard calculates error rates based on the is_error flow variable. That variable can be explicitly set by the API proxy, so it is not related to the error codes in the proxy response or target response.

When calculating error rates:

  • A proxy can handle a target error and still return a success response. In this case, the error is counted as a target error but not as a proxy error.

  • When the target response is either success or does not exist, but the proxy responded with an error, the error is counted against the proxy.

  • If both the proxy and target respond with an error, the error is counted on the target.

Video: Watch a short video for an overview of the Error Code Analysis dashboard.

The Error Code Analysis dashboard (partially shown)

Access the Error Code Analysis dashboard, as described below.

Edge

To access the Error Code Analysis dashboard using the Edge UI:

  1. Sign in to https://apigee.com/edge.
  2. Select Analyze > API Metrics > Error Code Analysis.

Classic Edge (Private Cloud)

To access the Error Code Analysis dashboard using the Classic Edge UI:

  1. Sign in to http://ms-ip:9000, where ms-ip is the IP address or DNS name of the Management Server node.
  2. Select Analytics > Error Code Analysis.

The dashboard opens as shown below:

What does this dashboard measure?

Error Composition

Metric Description
Total Errors

The total number of proxy errors + target errors that resulted from all requests and responses seen in an Apigee Edge organization over the specified time period.

See What does this dashboard tell me? for more on how Total Errors, Proxy Errors, and Target Errors are calculated.

Proxy Errors The total number of proxy errors seen in an Apigee Edge organization in the specified time period as determined by the response code. Proxy errors are measured between the time an entire request is received by Apigee Edge from a client and the time the request is sent to the backend target.
Target Errors The total number of target errors seen in an Apigee Edge organization in the specified time period as determined by the target response code. Target errors are measured between the time an entire request is sent by Apigee Edge to a backend target and the time the response is returned the client app.

Proxy Errors

Metric Description
Total Proxy Errors The total number of proxy errors seen in an Apigee Edge organization in the specified time period. Proxy errors are measured between the time an entire request is received by Apigee Edge from a client and the time the request is sent to the backend target.
4XX Shows the number proxy errors that resulted in HTTP 4xx errors. For a complete list of HTTP status codes, see "Status Code Definitions" in the HTTP specification.
5XX Shows the number API requests that resulted in HTTP 5xx errors. For a complete list of HTTP status codes, see "Status Code Definitions" in the HTTP specification.

Target Errors

Metric Description
Total Target Errors The total number of target errors seen in an Apigee Edge organization in the specified time period. Target errors are measured between the time an entire request is sent by Apigee Edge to a backend target and the time the response is returned the client app.
4XX The number target errors that resulted in HTTP 4xx errors. For a complete list of HTTP status codes, see "Status Code Definitions" in the HTTP specification.
5XX The number target errors that resulted in HTTP 5xx errors. For a complete list of HTTP status codes, see "Status Code Definitions" in the HTTP specification.

Errors by Proxy

Metric Description
<Proxy name>

The total number of proxy errors seen in an Apigee Edge organization in the specified time period for each individual proxy. Hover over the bars to see the number of errors that came from the each proxy request flow and from the target request flow, respectively.

Proxy errors are measured between the time an entire request is received by Apigee Edge from a client and the time the request is sent to the backend target.

Errors by Target

Metric Description
<Target name>

The total number of target errors seen in an Apigee Edge organization in the specified time for each individual target. The number of calls that did not reach any target are listed in the Target Not Contacted column. Hover over the bars to see the number of errors that came from the each proxy response flow and from the target response flow, respectively.

Target errors are measured between the time an entire request is sent by Apigee Edge to a backend target and the time the response is returned to the client app. The chart shows the number of errors that came from the proxy response flow and from the target response flow, respectively.

Proxy Errors by Response Code

Metric Description
<Response Code>

The total number of proxy errors seen in an Apigee Edge organization in the specified time that returned each response code. Hover over the bars to see the number of errors that returned each response code.

Target Errors by Response Code

Metric Description
<Response Code>

The total number of target errors seen in an Apigee Edge organization in the specified time that returned each response code. Hover over the bars to see the number of errors that returned each response code.

What else do I need to know about this dashboard?

You can view metrics for all proxies or drill into specific proxies using the Proxy dropdown menu at the top of the dashboard.

The list area to the right of each chart is interactive. Select a line in the list to toggle its view in the chart:

This dashboard uses standard controls, like the date and data aggregation selectors, hovering over graphs for more context, exporting data to CSV, and so on. To learn more, see Using the analytics dashboards.