API d.side Replay

API d.side Replay

 In Trucs et astuces
0
0

Trucs et Astuces

✓ d.side Replay

Introduction

Les données collectées par le job de capture de Replay via la procédure DSIDE_REPLAY.GATHER sont habituellement exploitées par d.side Interactive Replay.

Elles sont également faciles à transmettre via les outils d’export / import fournis.

Désormais, on peut même exploiter ces données sans passer par l’interface Replay.
En effet, le package PL/SQL DSIDE_REPLAY_API fournit des fonctions permettant d’extraire les données collectées dans le schéma Replay.

La plupart de ces fonctions renvoient une liste de (SNAPSHOT, VALUE) qui peuvent ainsi facilement être exploitées directement en SQL ou par des outils tiers d’analyse.

 

Architecture

 

Installation

Pour accéder à l’API il suffit de créer le package DSIDE_REPLAY_API à l’aide du script dsreplay_api.sql fourni sur demande à notre équipe support.

SQL> @dsreplay_api.sql
Package dropped.

Type dropped.

Type dropped.

Type created.

Type created.

Package created.

Package body created.

SQL>

 

Extraction de données à l’aide de l’API

Utilisation de l’API via des requêtes SQL

Une fois le package DSIDE_REPLAY_API créé, on a accès à de nombreuses fonctions permettant d’explorer ce qui a été collecté.
Voici trois exemples d’utilisation.

Pic de CPU atteint sur la machine au cours des 3 derniers jours :

SELECT MAX(VALUE) FROM TABLE(DSIDE_REPLAY_API.GET_HOST_CPU)
WHERE SNAP_DATE>SYSDATE-3;

Nombre de requêtes exécutées par heure, sur les 24 dernières heures :

SELECT to_char(snap_date, 'YYYYMMDDHH24'), sum(VALUE)
FROM TABLE(DSIDE_REPLAY_API.GET_EXECUTE_COUNT)
WHERE SNAP_DATE>SYSDATE-1
GROUP BY to_char(snap_date, 'YYYYMMDDHH24')
ORDER BY to_char(snap_date, 'YYYYMMDDHH24');

“TOP 10” des requêtes les plus consommatrices sur les 7 derniers jours :

column minsnap new_value beginsnap;
SELECT MIN(SNAP_ID) minsnap FROM TABLE(DSIDE_REPLAY_API.GET_SNAPS_LIST) WHERE SNAP_DATE>SYSDATE-7;
SELECT * FROM TABLE(DSIDE_REPLAY_API.GET_PERIOD_QUERIES(limit=>10, begin_snap=>&beginsnap));

 

Interface avec des outils tiers

Nous venons de voir comment il est très simple d’exploiter en SQL les données collectées.
Il est également possible de confier le résultat de ces extractions à des outils tiers.
Par exemple pour injecter les données collectées dans une base destinée à grafana, afin de produire des graphiques avec vos outils habituels.

 

Services REST

Enfin, de la même manière, il est possible d’interfacer l’API d.side avec une architecture REST.
Pour cela Oracle propose par exemple ORDS (Oracle REST Data Services) : https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/index.html

 

Remarque : l’utilisation de l’API d.side nécessite une version minimale d’Oracle. Le schéma de collecte Replay doit avoir été créé sur une base en Oracle 11g ou supérieure. Elle n’est donc pas compatible avec Oracle 10g.

 

, , , , , , , , ,
Recommended Posts