Troubleshoot with Reports

Updated

Introduction

The reports are an interactive way to filter and view different statistics about the ZEDEDA Cloud assets. You can use reports if you want to see more historical data than what you can see in your Dashboard or landing pages. You can also use reports for auditing or troubleshooting purposes. You can find Events, Utilization, Network Data Flow, and State of the Union reports here.

Prerequisites

  • If you have the SysAdmin role, you can see all the reports. 
  • If you do not have the SysAdmin role, you can’t see the State Of Union report.

Access the Reports

  1. Click the Reports icon from the left navigation.
  2. From the dropdown, select Events, Utilization, Network, or State Of Union reports.
  3. From the dropdown, select the appropriate options for the type of report.
  4. From the calendar option, select the appropriate duration to see the reports.

View the Events Reports

The Events Report shows All events or the events for Edge App Instances, Edge Nodes, Projects, or Users. 

You’ll see event statistics by severity, event statistics by objects, and edge node locations only for event reports of Edge App Instances, Edge Nodes, and Projects. 

  • From Reports > Events > Edge App Instances > YOUR_EDGE_APP_INSTANCE, you can see the Events Report for the Edge App Instance of your choice for the specified time range. Reviewing these events can help you verify if the Edge App Instance is performing as expected, and to detect any potential problems. For example:
    Run state changed from 'Online' to 'Error'.
  • From Reports > Events > Edge Nodes > YOUR_EDGE_NODE, you can see the Events Report for the Edge Node of your choice for the specified time range. Reviewing these logs can help you verify the health of your edge node, such as its deployment status, configuration changes, or state transitions. For example:
    Uplink Interface changed. Old: 'eth0', New: 'eth1'.
  • From Reports > Events > Projects > YOUR_PROJECT, you can see the Events Report for the Project of your choice for the specified time range. Reviewing events at the project level can help you identify patterns in system behavior, usage anomalies, or performance issues. For example:
    'Rebooted'. Reason: 'NORMAL: First boot of device - at 2024-09-30T15:59:28.579683194Z'.
  • From Reports > Events > Users > YOUR_USER_NAME, you can see the Events Report for the User of your choice for the specified time range. Reviewing these events helps you focus on the specific actions, events, and behaviors tied to a user in your platform. For example:
    Logged in after successful password verification.

Event Details

From each type of event, you’ll see the table view of your event details at the end of the report. 

Date & Time The timestamp of the event. 
Severity

The severity of the event, such as: 

  • Debug - Internal ZEDEDA use only. 
  • Info - Routine information, such as ongoing status or performance.
  • Notice - Normal but significant events such as: start up, shut down, or a configuration change.
  • Warning - Events that might cause problems.
  • Alert - Take action immediately.
  • Emergency - One or more systems are unusable.
Source

The source of the event, such as: 

  • Unspecified - default
  • System - event is generated as a result of status change reported by edge node or application
  • User - event is generated as a result of a user's configuration action
Applies to The name of the resource that the event applies to.
Project The name of the project that the event applies to. 
Description The brief description of the event.
Expand The dropdown icon to expand the description details. This is where you’ll find debug info, if applicable.  

Event Statistics by Severity

You’ll see the timestamp for each event, and the number of events based on the following severities: 

  • Critical
  • Warning
  • Info

You can filter on each severity to see only the ones of interest when you want to assess and prioritize high-impact events that need urgent attention. 

Event Statistics by Objects

You’ll see the timestamp for each event, and the number of events based on the following objects: 

  • Edge Nodes
  • Edge App Instances
  • Users

You can filter on each object to see only the ones of interest when you want to identify which ones are having the most issues or generating the most events. 

Edge Node Locations

You’ll see the location of your edge node on a map. This can help you with regional monitoring, troubleshooting, compliance, performance optimization, expansion planning, and security. By visualizing your edge node locations, you can make more informed decisions to ensure that your edge infrastructure is meeting specific local business requirements and regulatory standards.

View the Utilization Reports

From Reports > Utilization, you can see the Utilization Report for your objects (such as Edge App Instance, Edge Node, Project, or All) for the specified time range. 

CPU Total

You’ll see the timestamp and the number of seconds that the object has been utilizing CPU resources during the specified time range.  

You can monitor CPU Total to determine if the object is using more CPU than necessary. For example, CPU Total might indicate insufficient CPU resources if an Edge App Instance is experiencing performance problems.  

CPU Usage

You’ll see the timestamp and the percentage of CPU used during the specified time range. 

You can monitor CPU Usage to determine how much of the edge device's computational resources are being utilized by the object. For example, consistently high or consistently low percentages might indicate that an Edge App Instance is not configured for optimal CPU performance.  

Memory Utilization (Allocated)

You’ll see the timestamp and the percentage of the allocated memory utilized during the specified time range. 

You can monitor Memory Utilization (Allocated) to determine how much of the memory resources that have been reserved for the object are actively being used at any given time. For example, consistently high or consistently low percentages might indicate that an Edge App Instance is not utilizing memory efficiently.  

Storage Utilization (Allocated)

You’ll see the timestamp and the percentage of the allocated storage utilized during the specified time range.

You can monitor Storage Utilization (Allocated) to determine how much of the storage (disk space) resources that have been reserved for the object are actively being used at any given time. For example, if the allocation is consistently close to full, an Edge App Instance might not be able to store new data or logs.

Network Counters

You’ll see the timestamp and the total amount of data (in bytes) sent or received per interface during the specified time range.

You can monitor Network Counters to help maintain the frequency of consistent and reliable network communication. For example, counters can help you determine if sudden spikes or dips in traffic might indicate unexpectedly large data transfers or packet loss. 

Network Rates

You’ll see the timestamp and the throughput of traffic flow (in bps) per interface during the specified time range. 

You can monitor Network Rates to understand how much network bandwidth the object is consuming. For example, rates can ensure optimal network usage by helping you understand traffic patterns or determine network performance problems. 

Event Statistics by Severity

You’ll see the timestamp for each event, and the number of events based on the following severities: 

  • Critical
  • Warning
  • Info

You can filter on each severity to see only the ones of interest. 

Event Statistics by Objects

You’ll see the timestamp for each event, and the number of events based on the following objects: 

  • Edge Nodes
  • Edge App Instances
  • Users

You can filter on each object to see only the ones of interest. 

View the Network Reports

From Reports > Network > Traffic > Edge App Instances > YOUR_EDGE_APP_INSTANCE, you can see the Network Traffic Report for the Edge App Instance of your choice in Bytes or Packets for the specified time range. 

Traffic 

You’ll see the timestamp and the rate of traffic flow in bps per interface during the specified time range. 

Traffic generally focuses on total data volume rather than the rate or frequency at which data is transferred, which gives you a cumulative view of network activity. You can monitor Traffic to gauge how much bandwidth the object is consuming in total, helping you understand the load on the network. For example, in scenarios where network usage is metered, you might want to monitor the total volume of data transferred to avoid cost overruns.

Network Flow Log

You’ll see a Sankey diagram of the network flow captured as the traffic passes from the source to the destination with DNS, remote IP, protocol, remote port, ACL number involved, and permission allowing or blocking.


You can view this diagram to track the traffic flowing to and from your edge app instance, which helps in identifying any unusual spikes or drops in traffic.

View the State of the Union Reports

From Reports > State Of Union, you can see an overall Summary per enterprise or the Edge Nodes per enterprise. 

The Summary view provides a high-level overview of your enterprise. It consolidates key metrics and health indicators for your entire fleet of edge nodes, app instances, users, plugins, and projects, giving you a quick snapshot of the overall system health and performance.

The Edge Nodes report dives deeper into the specific status and metrics of each individual edge node. It gives detailed information about the tier distribution of each node in your enterprise.

Was this article helpful?
2 out of 2 found this helpful