How To: Access Kognitive Cloud Reports

Overview

This document explains the process of accessing Kognitive Cloud Reports. The reports are automatically created at regular intervals and shared with Distribution Partners (DPs) through secure SAS tokens.

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.