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
}