How To: Access Kognitive Cloud Reports

Overview

This guide explains how to access and retrieve Kognitive Cloud Reports, which are generated automatically at regular intervals and stored in compressed .csv.gz files for distribution partners. It describes the report types (such as site usage, quota, location, application activity, user activity, and domain activity), the storage structure organized by DP ID and report category, and how to use secure SAS tokens with tools like AzCopy or SDKs (Python, .NET, Java, etc.) to download these reports. By following this guide, you will be able to locate, download, and decompress Cloud Report files for analysis and integration into your workflows.

Kognitive Cloud Reports

Kognitive Cloud Reports are generated every 1 hour and stored for user reference.
Reports are compressed in .csv.gz format. A sample file name would be Site_vessel_2025_06_03_014133.csv.gz
Storage & Folder Structure - Reports are organized by DP ID → Report Type (site/activity) → Subtype (vessel/quota/etc.) → Date.
- Reports follow this naming convention:
  <ReportType><Subtype><YYYY><MM><DD>_<HHMMSS>.csv.gz
The following six types of Kognitive Cloud Reports are created
- Site – Vessel
  Site dashboard data including usage distribution, WAN type usage, top apps, and internet status.
- Site – Quota
  Quota usage per site (percentage used, max quota, estimated over-date).
- Site – Location
  Hourly snapshot of site location (longitude, latitude, source).
  Sources include VSAT, LTE, Starlink, Manual and other sources like marine traffic.
- Activity – Application
  Application-wise usage (download, upload, blocked).
- Activity – Users
  User-wise usage including hostname, IP, MAC, device, VLAN, usage totals, top apps, and risk score.
- Activity – Domain
  Domain-wise usage (download/upload volume, blocked hits).

How To Access

Access to folders is managed using SAS tokens generated per DP folder. Reach out to Kognitive Support team to get the SAS token.
Use AzCopy or SDK (Python, .NET, Java, etc.) to download files.
Example command: ./azcopy ls "<https://<storageaccount>>.blob.core.windows.net/reports/DP/DP-0001?<SAS-token>"
Reports are compressed (.csv.gz) - decompress to view.
Token expiry - request a new token when expired.