Database

데이터베이스 모니터링 프로젝트의 에이전트 정보 및 파라미터 변동 사항, 통계 정보를 조회를 위한 API를 제공합니다.

데이터베이스 파라미터 조회

데이버베이스의 파라미터의 변경 사항을 조회할 수 있습니다.

GET https://api.whatap.io/open/api/json/db/database_params?oid=[oid]&baseTime=[baseTime]&comparisonTime=[comparisonTime]

request

$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/db/database_params?oid=376886006&baseTime=20230822&comparisonTime=20230810"

Request Field	Field Type	Description
oid	number · 필수	에이전트 ID
baseTime	string · 필수	기준 시간, yyyyMMdd 형식
comparisontime	string · 필수	비교 시간, yyyyMMdd 형식

response

{
    "unmatchedKeys": [
        {
            "key": "Innodb_buffer_pool_load_status(stat)",
            "value": {
                "baseTime": "Buffer pool(s) load completed at 230818  2:54:51",
                "comparisonTime": "Buffer pool(s) load completed at 230810  6:05:50"
            }
        },
        {
            "key": "Max_used_connections_time(stat)",
            "value": {
                "baseTime": "2023-08-18 23:54:51",
                "comparisonTime": "2023-08-10 06:05:51"
            }
        }
    ],
    "baseTime": [
        {
            "key": "activate_all_roles_on_login",
            "value": "OFF"
        },
        {
            "key": "admin_address",
            "value": ""
        },
        ...
    ],
    "comparisonTime": [
        {
            "key": "activate_all_roles_on_login",
            "value": "OFF"
        },
        {
            "key": "admin_address",
            "value": ""
        },
        ...
    ]
}

SQL 통계 TopN

가장 많이 이용된 SQL 통계 정보를 조회할 수 있습니다.

GET https://api.whatap.io/open/api/json/db/statistics/sql?oids=[oid]&period=[day|week]&date=[date]

request

$ curl -L -w "\n" -H "x-whatap-token: {{PROJECT API TOKEN}}" -H "x-whatap-pcode: {{projectCode}}" "https://api.whatap.io/open/api/json/db/statistics/sql?oids=757639646,-1162364681,506793303&period=day&date=20230825"

Request Field	Field Type	Value	Description	Defalut
oids	array · 필수	-	에이전트 ID, 쉼표(,)를 구분자로 복수 입력 가능	-
period	string · 필수	day, week	조회 기간	-
date	string · 필수	yyyyMMdd 형식	기준 시간	-
topN	number	1 ~ 1000	상위 건수	10
order	string	sql_execute_cnt sql_elapse sql_elapse_max	정렬 순서	sql_execute_cnt
category	string	ALL DB HOST USER	카테고리, USER를 선택하면 사용자 기준으로 SQL 통계 데이터 응답	ALL
nameInCategory	string	-	category 선택 시 입력	-

response

{
    "records": [
        {
            "sql_execute_cnt": 33863,
            "sql_elapse": 643,
            "sqlHash": 1559625025,
            "sql_elapse_max": 5,
            "onames": "DBX-0-102-3306,DBX-0-162-3306",
            "user": "kwlee",
            "sql": "select /* WhaTap6D#5 */ * from information_schema.processlist\nwhere command<>'#'"
        },
        {
            "sql_execute_cnt": 28387,
            "sql_elapse": 0,
            "sqlHash": -499643965,
            "sql_elapse_max": 0,
            "onames": "DBX-0-107-3306",
            "user": "whatap",
            "sql": "select id,user,host,db,command,time,state,info,time_ms,stage,max_stage,progress,\nmemory_used,max_memory_used,examined_rows,query_id,tid\nfrom information_schema.processlist\nwhere command<>'#' and command<>'#'"
        },
       ...
    ],
    "topN": 10,
    "total": 129,
    "retrievedStartTime": 1692921600000,
    "retrievedEndTime": 1693007999000
}