Introduction to Monitoring Health with Analytics
You can monitor the health and performance of any service, service version, route, or application managed by Kong Konnect.
Analytics provides traffic reports to help you track the performance and behavior of your APIs and runtimes. Use these reports to quickly access key statistics, monitor vital signs, and pinpoint anomalies in real time.
Depending on your Kong Konnect subscription tier, Analytics retains historical data for the following lengths of time:
- Free: 24 hours
- Plus: 3 months
- Enterprise: 1 year
Contextual analytics for services and routes
In the Service Hub, you can see activity graphs for services, service versions, or routes for the past 30 days. For services, these graphs display request counts. For service versions and routes, the graphs show requests broken down by status codes.
Figure 1: Graph showing throughput for a service with interval filter options.
You can also export this historical data in CSV format for any individual service, service version, or route.
Summary dashboard and custom reports
For greater insights into your service usage, access the dedicated Analytics page.
From Analytics, you can view dashboards, access historical data for a range greater than 30 days, and customize the entities in a report:
- View the Analytics summary dashboard to track traffic, errors by error code, and latency across all services in your organization.
- Export historical data in CSV format for any individual service, service version, or route.
- Create a custom report for any number of services, routes, or applications, filtered by time frame and grouped by metric.
The summary dashboard provides metrics across all services in your organization within a selected time interval for the following categories:
- Traffic
- Errors
- Latency
These categories measure trends by comparing metrics across fixed comparable time intervals and plotting the data points. For example, hour-over-hour, day-over-day, week-over-week, and month-over-month. You can view a graph for each category by clicking Traffic, Errors, or Latency, and switching between the views.
-
Traffic: This graph displays the total number of HTTP requests categorized by successful and failed requests over the specified time interval.
- Successful requests contain all requests that returned a 1xx-3xx status code.
- Failed requests contain all requests that returned a 4xx-5xx status code.
- 6xx status codes are not reported.
Figure 2: Graph showing successful and failed requests over the past three hours.
-
Errors: This graph displays the total number of failed HTTP requests categorized by error response codes over the specified time interval. Error response codes include any 4xx-5xx status codes.
Figure 3: Graph showing errors by 4xx and 5xx error codes received over the past three hours.
-
Latency: This graph displays request latency, in milliseconds, of the 99th, 95th, and 50th percentiles. Admins can monitor the latency, investigate where delays are noticed, and optimize performance for APIs.
Note: Latency data is only available for requests proxied through runtime instances running Kong Gateway 3.0.0.0 or later.
Figure 4: Graph showing latency as a percentage over the past 15 minutes.
Graphs can be interacted with, including hovering over chart items to display more details, and filtering options by clicking on items in the legend.
You can select a time period using the time period drop-down menu. The intervals aggregate data at different increments of time.
Team permissions
You can assign Konnect users to specific, predefined Analytic teams. This gives you the ability to allow certain users to only view or manage the Analytics area of your Konnect instance. For more information about the Analytics Admin and Analytics Viewer teams, see the Teams Reference.