Skip to main content

Viewing the statistical data

Guide to parameters configuration​

ParameterDescription
stimeLookup start time UTC (UNIX epoch time, millisecond)
etimeLookup end time UTC (UNIX epoch time, millisecond)
filterAutomatic setting of m5 by default; if 5-minute statistics are fetched within the time range, m5 is used.
For 5-second statistics, s5 is used and for 1-hour statistics, h1 is used.
oidAdd if monitoring is required for a specific server.

Exception​

GET https://api.whatap.io/open/api/json/exception/stime/etime

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/exception/1535554800000/1535641200000"
response
{
  "records": [
    {
      "oids": "[-1459620666]",
      "time": 1535557500000,
      "classHash": -1811136020,
      "count": 14,
      "service": "/account/delete/dept/daegu",
      "class": "java.sql.SQLException(0)",
      "serviceHash": 1900616259,
      "snapSeq": "6068699991557528332",
      "msg": "Sql Exception"
    },
    (...)
  ],
  "total": 2063
}

HTTP outbound call​

GET https://api.whatap.io/open/api/json/httpc/stime/etime

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/httpc/1535554800000/1535641200000"
response
{
  "records": [
    {
      "Sum": 22628,
      "Port": 10002,
      "Url": "/remote/account/save/employee/kwangju",
      "Host": "127.0.0.1",
      "Max": 1815,
      "Stdev": "247.95",
      "Actived": 0,
      "Avg": 1131,
      "HostHash": -675813464,
      "Min": 1002,
      "Error": 0,
      "Total": 20,
      "UrlHash": -243814510
    },
    (...)
  ],
  "total": 4923
}

HTTP outbound call filtering in case the host is 127.0.0.1 and the port is 1007

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/httpc/1543219200000/1543478400000/filter/host/127.0.0.1/port/10007"
response
{
  "records": [
    {
      "Service": "/sales/remove/unit/kwangju",
      "Host": "127.0.0.1",
      "HostHash": -675813464,
      "Avg": 1080,
      "Error": 0,
      "Sum": 2411644,
      "Port": 10007,
      "Service_hash": -1003301916,
      "Url": "/remote/account/save/employee/seoul",
      "Max": 2442,
      "Stdev": "159.01",
      "UrlHash": 180997672,
      "Total": 2233,
      "Min": 1001
    },
    {
      "Service": "/product/delete/employee/daejun",
      "Host": "127.0.0.1",
      "HostHash": -675813464,
      "Avg": 1085,
      "Error": 0,
      "Sum": 2075036,
      "Port": 10007,
      "Service_hash": 2100205994,
      "Url": "/remote/account/save/employee/pusan",
      "Max": 2462,
      "Stdev": "173.06",
      "UrlHash": -924053750,
      "Total": 1911,
      "Min": 1001
    },
    (...)
  ],
  "total": 1080
}

SQL​

GET https://api.whatap.io/open/api/json/sql/stime/etime

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/sql/1535554800000/1535641200000"
response
{
  "records": [
    {
      "time_max": 4164,
      "dbcHash": 450678784,
      "db": "jdbc:mysql://localhost:3306,localhost:3310/fake", "time_min": 0,
      "fetch_count": 0,
      "hash": 796628118,
      "fetch_time": 0,
      "sql_crud": 0,
      "count_total": 5224,
      "count_error": 0,
      "sql": "update table set x=# where key=#",
      "time_sum": 581391,
      "time_avg": 111,
      "time_std": "240.79",
      "count_actived": 0
    },
    (...)
  ],
  "total": 130
}

client IP​

GET https://api.whatap.io/open/api/json/remote/stime/etime

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/remote/1535554800000/1535641200000"
response
{
  "records": [
    {
      "count": 86,
      "city": "Winnipeg",
      "country": "CA (CANADA)",
      "ip": "140.193.83.68"
    },
    (...)
  ],
  "total": 1000
}
Note

WhaTap basically stores the client-related information.

Transactions​

GET https://api.whatap.io/open/api/json/transaction/stime/etime

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/transaction/1535554800000/1535641200000"
response
{
  "records": [
    {
        "apdex_tolerated": 98,
        "apdex_satisfied": 279,
        "apdex": 0.830379746835443,
        "time_max": 44735,
        "sql_fetch_time": 363,
        "sql_time": 2628663,
        "count": 10743,
        "error": 29,
        "sql_count": 22635,
        "hash": -1485863373,
        "sql_fetch": 6741607,
        "httpc_avg": 1084,
        "cpu_avg": 0,
        "time_sum": 19911778,
        "time_avg": 1853,
        "httpc_count": 7072,
        "service": "/account/save/employee/seoul",
        "mem_avg": 0
    },
    (...)
  ],
  "total": 1080
}

Viewing the heap usage​

You can query statistics on the heap usage.

Note

Search time (stime, etime) is limited to one hour, and its unit is in ms (millisecond).

Request for the statistical average​

GET https://api.whatap.io/open/api/json/heap_use/stime/etime/avg

command
curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/heap_use/{sitme}/{etime}/avg"

Request for the statistical maximum​

GET https://api.whatap.io/open/api/json/heap_use/stime/etime/max

command
curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/heap_use/{sitme}/{etime}/max"
response
{
  "pcode": 5490,
  "stime": 1677747600000,
  "etime": 1677749594269,
  "timeMerge": "avg",
  "unit": "byte",
  "data": [
    {
        "oid": -1143239575,
        "oname": "demo-8101",
        "heap_use": "36121554.72"
    },
    {
        "oid": -857948929,
        "oname": "demo-8105",
        "heap_use": "37498925.139"
    },
    (...)
  ]
}
Response FieldField TypeDescription
pcodenumberQueried projected code
stimenumberStatistics lookup start time
etimenumberStatistics lookup end time
timeMergestringData merge strategy for the statistics lookup period
unitstringHeap usage unit
dataarrayStatistical data
oidnumberAgent ID
onamestringAgent name
heap_usestringHeap usage

Viewing the agent data​

Example of viewing the individual agent data​

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/thread_count/1536050100000/1536050700000"
response
{
  "pcode": 1234570141,
  "type": "thread_count",
  "stime": 1536050100000,
  "etime": 1536050700000,
  "interval": 300, // data point interval
  "timeMerge": "sum",
  "objects": [
    {
      "oname": "8080",
      "oid": -1234257485,
      "series": [
        [
          1536050100000, // time-series timestamp
          95.2
        ],
        [
          1536050400000,
          85.3
        ],
        [
          1536050700000,
          91.43
        ]
      ]
    },
    (...)
    {
      "oname": "TC-29-96-8082",
      "oid": 1482741919,
      "series": [
        [
          1536050100000,
          98.11
        ],
        [
          1536050400000,
          81.44
        ],
        [
          1536050700000,
          90.05
        ]
      ]
    }
  ]
}

Example of viewing the average agent data​

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/thread_count/1536050100000/1536050700000/avg"
response
{
  "pcode": 1234570141,
  "type": "thread_count",
  "stime": 1536050100000,
  "etime": 1536050700000,
  "interval": 300, // data point interval
  "timeMerge": "sum",
  "objectMerge": "avg",
  "series": [
    [
      1536050100000, // time-series timestamp
      122.86 // average data of all agents
    ],
    [
      1536050400000,
      99.26
    ],
    [
      1536050700000,
      109.68
    ]
  ]
}

Example of viewing the agent-specific data​

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/thread_count/1536050100000/1536050700000/-1050048219,-1459620666"
response
{
  "pcode": 1234570141,
  "type": "thread_count",
  "stime": 1536050100000,
  "etime": 1536050700000,
  "interval": 300,
  "timeMerge": "sum",
  "objects": [
    {
      "oname": "8081",
      "oid": -1050048219, // Viewing the specified agent information
      "series": [
        [
          1536050100000,
          97.75
        ],
        [
          1536050400000,
          98
        ]
      ]
    },
    {
      "oname": "8073",
      "oid": -1459620666, // Viewing the specified agent information
      "series": [
        [
          1536050100000,
          137.23
        ],
        [
          1536050400000
          102.53
        ],
        [
          1536050700000,
          120.2
        ]
      ]
    }
  ]
}

Example of viewing the agent-specific average data​

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/thread_count/1536050100000/1536050700000/avg/-1050048219,-1459620666"
response
{
  "pcode": 1234570141,
  "type": "thread_count",
  "stime": 1536050100000,
  "etime": 1536050700000,
  "interval": 300,
  "timeMerge": "sum",
  "objectMerge": "avg",
  "series": [
    [
      1536050100000,
      117.49 // Viewing the average metrics of the set agents
    ],
    [
      1536050400000,
      100.26
    ],
    [
      1536050700000,
      120.2
    ]
  ]
}

Active users (5-minute increment)​

GET https://api.whatap.io/open/api/json/visitor_5m/stime/etime

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/visitor_5m/1554444000000/1554076800000"
response
{
  "data": [
    [
      1554444005000, // 1-hour unit (5*60*1000)
      12
    ],
    [
      1554444010000,
      12
    ],
    (...)
  ],
  "pcode": 3000000079,
  "stime": 1554444000000,
  "etime": 1554444300000,
  "total": 59
}
Note

WhaTap measures concurrent users by counting them who issued transactions within the last 5 minutes.

Active users (1-hour increment)​

GET https://api.whatap.io/open/api/json/visitor_h/stime/etime

command
$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/visitor_h/1554444000000/1554454800000"
response
{
  "data": [
    [
      1554444000000, // 1-hour unit (60*60*1000)
      18
    ],
    [
      1554447600000,
      16
    ],
    (...)
  ],
  "pcode": 3000000079,
  "stime": 1554444000000,
  "etime": 1554454800000,
  "total": 3
}

Transaction call statistics between projects​

Note
  • filterkey: lookup condition key (caller_pcode, caller_spec (version), caller_url, spec (version), url)
  • filterval: lookup condition (if filterkey is caller_url or url, base64 encoding is applied)

Domain call statistics​

Note
  • filterkey: lookup condition key (caller_pcode, caller_spec (version), caller_url, spec (version), url)
  • filterval: lookup condition (if filterkey is caller_url or url, base64 encoding is applied)