Application Statistics

curl -X GET "https://<hostname>/ekranapi/statistics/getapp?start=2021-09-01&end=2021-09-02" \
  -H "ApiKey: xJ)tsCNcpj)l+]}(@_|lt!t………"

[
  {
    "data": [
      {
        "duration": "00:02:50.3010000",
        "key": "explorer.exe"
      },
      {
        "duration": "00:02:50.3010000",
        "key": "chrome.exe"
      }
    ],
    "sessionId": 134,
    "timeOfDay": "2021-09-01T17:00:00+03:00"
  },
  {
    "data": [
      {
        "duration": "01:02:50.3010000",
        "key": "cmd.exe"
      },
      {
        "duration": "00:01:00.3010000",
        "key": "Idle"
      }
    ],
    "sessionId": 431,
    "timeOfDay": "2022-02-01T17:00:00+07:00"
  }
]

Returns time spent in each application broken down by hour and session — useful for “which apps did the user spend the most time in this morning?” style analytics. Each result is a (sessionId, hour, application → duration) triple.

GET https://<hostname>/ekranapi/statistics/getapp

Authentication

string

required

Your Active API Key from the Management Tool.

Query parameters

string

Sessions that were started or finished after this time are included.Accepted formats: 2021-04-01, 2021-04-01T12:00, 2021-04-01T12:00:00.

string

Sessions that were started or finished before this time are included.

If both start and end are omitted, statistics for all sessions in the database are returned. See Time parameter conventions for full rules and boundary clipping behavior.

Response (200 OK)

The response is an array of (session, hour) blocks. Each block has a data array — one entry per application — plus sessionId and timeOfDay fields.

array

Array of per-application time records for this (session, hour):

Show Per-application record

timespan

Total time spent in this application during this hour of this session — format hh:mm:ss.fffffff.

string

The name of the application (e.g. chrome.exe, explorer.exe, cmd.exe, or Idle for idle time).

int32

The ID of the session this block belongs to.

date-time

The hour of the day (ISO 8601 with hour granularity).

The application name Idle appears alongside real application names — it represents the time the user was inactive during the hour. Filter it out client-side if you only want active-app time.

Example

curl -X GET "https://<hostname>/ekranapi/statistics/getapp?start=2021-09-01&end=2021-09-02" \
  -H "ApiKey: xJ)tsCNcpj)l+]}(@_|lt!t………"

[
  {
    "data": [
      {
        "duration": "00:02:50.3010000",
        "key": "explorer.exe"
      },
      {
        "duration": "00:02:50.3010000",
        "key": "chrome.exe"
      }
    ],
    "sessionId": 134,
    "timeOfDay": "2021-09-01T17:00:00+03:00"
  },
  {
    "data": [
      {
        "duration": "01:02:50.3010000",
        "key": "cmd.exe"
      },
      {
        "duration": "00:01:00.3010000",
        "key": "Idle"
      }
    ],
    "sessionId": 431,
    "timeOfDay": "2022-02-01T17:00:00+07:00"
  }
]

Errors

See Status codes. Common errors:

400 Bad Request — invalid start or end format.
403 Forbidden — Data Connector not registered.

URL statistics

Same shape, but for URLs instead of applications.

User productivity

Aggregate active time per user per hour — complements per-application data.

List sessions with productivity

Get sessions with overall duration and productivity time.

API reference

Base URL, authentication, status codes.

Overview

Application Credentials Broker

Data Connector API

SSO & LDAP

SIEM & Ticketing systems

Application Statistics

Authentication

Query parameters

Response (200 OK)

Example

Errors

URL statistics

User productivity

List sessions with productivity

API reference

​Authentication

​Query parameters

​Response (200 OK)

​Example

​Errors

​Related

URL statistics

User productivity

List sessions with productivity

API reference

Authentication

Query parameters

Response (200 OK)

Example

Errors

Related