Gestion des tableaux de bord à l'aide du client Python
Utilisez le client Python pour gérer les tableaux de bord à l'aide d'un programme.
Pour savoir comment utiliser le client Python, voir Utilisation du client Python.
Pour utiliser les ressources d'une équipe spécifique, vous devez utiliser le jeton (sysdig) de surveillance.
Le tableau suivant répertorie certaines des fonctions Python que vous pouvez utiliser pour gérer les tableaux de bord :
Action | Fonction |
---|---|
Créer un tableau de bord | sdclient.create_dashboard(dashboard_name) |
Création d'un tableau de bord à partir d'un fichier | sdclient.create_dashboard_from_file('dashboard_name', 'dashboard_name.json', scope_filter, shared=False, public=True) |
Copie d'un tableau de bord | sdclient.create_dashboard_from_dashboard(dashboard_name, existing_dashboard_name, scope_filter, shared=False, public=True) |
Téléchargement d'un tableau de bord | sdclient.get_dashboards() |
Mise à jour d'un tableau | sdclient.update_dashboard(dashboard_name) |
Suppression d'un tableau de bord | sdclient.delete_dashboard(dashboard_name) |
Recherche d'un tableau de bord | sdclient.find_dashboard_by(dashboard_name) |
Ajout d'une série temporelle | sdclient.add_dashboard_panel(dashboard_name, panel_name, panel_type, metrics, scope=scope) |
Ajout d'un panneau de tableau de bord | sdclient.add_dashboard_panel(dashboard_name, panel_name, panel_type, metrics, sort_direction=sort_direction, limit=limit, layout=layout) |
Suppression d'un panneau | sdclient.remove_dashboard_panel(dashboard_name, 'CPU Over Time') |
Sauvegarde d'un tableau de bord dans un fichier | sdclient.save_dashboard_to_file('dashboard_name', 'dashboard_name.json') |
Liste des tableaux de bord par équipe
Vous pouvez utiliser Python pour répertorier les tableaux de bord disponibles pour les équipes.
Liste des tableaux de bord disponibles dans l'équipe par défaut
Le code suivant présente la structure d'un script Python permettant de répertorier les tableaux de bord disponibles dans l'équipe par défaut.
#!/usr/bin/env python3
import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), '..'))
from sdcclient import IbmAuthHelper, SdMonitorClient
# Parse arguments.
def usage():
print('usage: %s <endpoint-url> <apikey> <instance-guid>' % sys.argv[0])
print('endpoint-url: The endpoint URL that should point to IBM Cloud')
print('apikey: IBM Cloud IAM apikey that will be used to retrieve an access token')
print('instance-guid: GUID of an IBM Cloud Monitoring with monitoring instance')
sys.exit(1)
if len(sys.argv) != 4:
usage()
URL = sys.argv[1]
APIKEY = sys.argv[2]
GUID = sys.argv[3]
# Instantiate the client
ibm_headers = IbmAuthHelper.get_headers(URL, APIKEY, GUID)
sdclient = SdMonitorClient(sdc_url=URL, custom_headers=ibm_headers)
# Show the list of dashboards
ok, res = sdclient.get_dashboards()
if not ok:
print(res)
sys.exit(1)
for db in res['dashboards']:
print("%s [Team ID: %s] Name: %s, # Charts: %d" % ( db['id'], db['teamId'], db['name'], len(db['widgets'] if 'widgets' in db else [])))
Liste des tableaux de bord disponibles dans une équipe
Le code suivant présente la structure d'un script Python permettant de répertorier les tableaux de bord disponibles pour une équipe spécifique.
#!/usr/bin/env python3
import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), '..'))
from sdcclient import SdMonitorClient
# Parse arguments.
def usage():
print('usage: %s <endpoint-url> <sysdig_token>' % sys.argv[0])
print('endpoint-url: The endpoint URL that should point to IBM Cloud')
print('sysdig_token: Sysdig token for the team')
sys.exit(1)
if len(sys.argv) != 3:
usage()
URL = sys.argv[1]
# Set to the Sysdig token of the team
SYSDIG_TOKEN = sys.argv[2]
sdclient = SdMonitorClient(token=SYSDIG_TOKEN,sdc_url=URL)
# Show the list of dashboards
ok, res = sdclient.get_dashboards()
if not ok:
print(res)
sys.exit(1)
for db in res['dashboards']:
print("%s [Team ID: %s] Name: %s, # Charts: %d" % ( db['id'], db['teamId'], db['name'], len(db['widgets'] if 'widgets' in db else [])))
Créer un tableau de bord
Vous pouvez utiliser Python pour créer des tableaux de bord.
Création d'un tableau de bord dans l'équipe par défaut
Le code suivant présente la structure d'un script Python permettant de créer un tableau de bord pour l'équipe par défaut.
Le code suivant présente la structure d'un script Python :
#!/usr/bin/env python3
import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), '..'))
from sdcclient import IbmAuthHelper, SdMonitorClient
# Parse arguments.
def usage():
print('usage: %s <endpoint-url> <apikey> <instance-guid>' % sys.argv[0])
print('endpoint-url: The endpoint URL that should point to IBM Cloud')
print('apikey: IBM Cloud IAM apikey that will be used to retrieve an access token')
print('instance-guid: GUID of an IBM Cloud Monitoring with monitoring instance')
sys.exit(1)
if len(sys.argv) != 4:
usage()
URL = sys.argv[1]
APIKEY = sys.argv[2]
GUID = sys.argv[3]
DASHBOARD_NAME = 'My New Dashboard from Python'
PANEL_NAME = 'CPU Over Time'
# Instantiate the client
ibm_headers = IbmAuthHelper.get_headers(URL, APIKEY, GUID)
sdclient = SdMonitorClient(sdc_url=URL, custom_headers=ibm_headers)
# Create an empty dashboard
ok, res = sdclient.create_dashboard(DASHBOARD_NAME)
# Check the result
dashboard_name = None
if ok:
print('Dashboard %d created successfully' % res['dashboard']['id'])
dashboard_name = res['dashboard']
else:
print(res)
sys.exit(1)
# Add a time series panel
panel_type = 'timeSeries'
metrics = [
{'id': 'proc.name'},
{'id': 'cpu.used.percent', 'aggregations': {'time': 'avg', 'group': 'avg'}}
]
ok, res = sdclient.add_dashboard_panel(
dashboard_name, PANEL_NAME, panel_type, metrics)
# Check the result
if ok:
print('Panel added successfully')
dashboard_name = res['dashboard']
else:
print(res)
sys.exit(1)
Créer un tableau de bord dans une équipe
Le code suivant montre la structure d'un script Python permettant de créer un tableau de bord pour une équipe spécifique.
#!/usr/bin/env python3
import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), '..'))
from sdcclient import SdMonitorClient
# Parse arguments.
def usage():
print('usage: %s <endpoint-url> <sysdig_token>' % sys.argv[0])
print('endpoint-url: The endpoint URL that should point to IBM Cloud')
print('sysdig_token: Sysdig token for the team')
sys.exit(1)
if len(sys.argv) != 3:
usage()
URL = sys.argv[1]
# Set to the Sysdig token of the team
SYSDIG_TOKEN = sys.argv[2]
DASHBOARD_NAME = 'My New Dashboard from Python'
PANEL_NAME = 'CPU Over Time'
sdclient = SdMonitorClient(token=SYSDIG_TOKEN,sdc_url=URL)
# Create an empty dashboard
ok, res = sdclient.create_dashboard(DASHBOARD_NAME)
# Check the result
dashboard_name = None
if ok:
print('Dashboard %d created successfully' % res['dashboard']['id'])
dashboard_name = res['dashboard']
else:
print(res)
sys.exit(1)
# Add a time series panel
panel_type = 'timeSeries'
metrics = [
{'id': 'proc.name'},
{'id': 'cpu.used.percent', 'aggregations': {'time': 'avg', 'group': 'avg'}}
]
ok, res = sdclient.add_dashboard_panel(
dashboard_name, PANEL_NAME, panel_type, metrics)
# Check the result
if ok:
print('Panel added successfully')
dashboard_name = res['dashboard']
else:
print(res)
sys.exit(1)
Copie d'un tableau de bord
Vous pouvez utiliser Python pour copier des tableaux de bord.
Copier un tableau de bord personnalisé dans l'équipe par défaut
Le code suivant montre la structure d'un script Python permettant de copier un tableau de bord personnalisé dans l'équipe par défaut.
#!/usr/bin/env python3
import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), '..'))
from sdcclient import IbmAuthHelper, SdMonitorClient
# Parse arguments.
def usage():
print('usage: %s <endpoint-url> <apikey> <instance-guid>' % sys.argv[0])
print('endpoint-url: The endpoint URL that should point to IBM Cloud')
print('apikey: IBM Cloud IAM apikey that will be used to retrieve an access token')
print('instance-guid: GUID of an IBM Cloud Monitoring with monitoring instance')
sys.exit(1)
if len(sys.argv) != 4:
usage()
URL = sys.argv[1]
APIKEY = sys.argv[2]
GUID = sys.argv[3]
# Name for the dashboard to create
dashboard_name = "My new CPU dashboard"
# Existing dashboard to copy
existing_dashboard_name = "My Existing Dashboard"
# New filter to apply
scope_filter = 'host.hostName = "virtualserver02"'
# Instantiate the client
ibm_headers = IbmAuthHelper.get_headers(URL, APIKEY, GUID)
sdclient = SdMonitorClient(sdc_url=URL, custom_headers=ibm_headers)
# Copy a dashboard
ok, res = sdclient.create_dashboard_from_dashboard(dashboard_name, existing_dashboard_name, scope_filter, shared=False, public=True)
# Check the result
#
if ok:
print('Dashboard created successfully')
else:
print(res)
sys.exit(1)
Copier un tableau de bord prédéfini dans l'équipe par défaut
Le code suivant montre la structure d'un script Python permettant de copier un tableau de bord prédéfini dans l'équipe par défaut.
#!/usr/bin/env python3
import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), '..'))
from sdcclient import IbmAuthHelper, SdMonitorClient
# Parse arguments.
def usage():
print('usage: %s <endpoint-url> <apikey> <instance-guid>' % sys.argv[0])
print('endpoint-url: The endpoint URL that should point to IBM Cloud')
print('apikey: IBM Cloud IAM apikey that will be used to retrieve an access token')
print('instance-guid: GUID of an IBM Cloud Monitoring with monitoring instance')
sys.exit(1)
if len(sys.argv) != 4:
usage()
URL = sys.argv[1]
APIKEY = sys.argv[2]
GUID = sys.argv[3]
# Name for the dashboard to create
dashboard_name = "My Overview by Process"
# Existing dashboard to copy
default_dashboard_name = "Overview by Process"
# New filter to apply
scope_filter = 'host.hostName = "virtualserver02"'
# Instantiate the client
ibm_headers = IbmAuthHelper.get_headers(URL, APIKEY, GUID)
sdclient = SdMonitorClient(sdc_url=URL, custom_headers=ibm_headers)
# Copy a dashboard
ok, res = sdclient.create_dashboard_from_view(dashboard_name, default_dashboard_name, scope_filter, shared=False, public=True)
# Check the result
#
if ok:
print('Dashboard created successfully')
else:
print(res)
sys.exit(1)
Copier un tableau de bord dans une équipe
Le code suivant montre la structure d'un script Python permettant de copier un tableau de bord dans une équipe.
#!/usr/bin/env python3
import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), '..'))
from sdcclient import SdMonitorClient
# Parse arguments.
def usage():
print('usage: %s <endpoint-url> <sysdig_token>' % sys.argv[0])
print('endpoint-url: The endpoint URL that should point to IBM Cloud')
print('sysdig_token: Sysdig token for the team')
sys.exit(1)
if len(sys.argv) != 3:
usage()
URL = sys.argv[1]
# Set to the Sysdig token of the team
SYSDIG_TOKEN = sys.argv[2]
# Name for the dashboard to create
dashboard_name = "My new CPU dashboard"
# Existing dashboard to copy
existing_dashboard_name = "My Existing Dashboard"
# New filter to apply
scope_filter = 'host.hostName = "virtualserver02"'
sdclient = SdMonitorClient(token=SYSDIG_TOKEN,sdc_url=URL)
# Copy a dashboard
ok, res = sdclient.create_dashboard_from_dashboard(dashboard_name, existing_dashboard_name, scope_filter, shared=False, public=True)
# Check the result
#
if ok:
print('Dashboard created successfully')
else:
print(res)
sys.exit(1)
Suppression d'un tableau de bord
Vous pouvez utiliserPython pour supprimer un tableau de bord.
Vous devez connaître l'ID d'un tableau de bord pour le supprimer.
Supprimer un tableau de bord de l'équipe par défaut
Le code suivant montre la structure d'un script Python permettant de supprimer un tableau de bord de l'équipe par défaut.
#!/usr/bin/env python3
import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), '..'))
from sdcclient import IbmAuthHelper, SdMonitorClient
# Parse arguments.
def usage():
print('usage: %s <endpoint-url> <apikey> <instance-guid>' % sys.argv[0])
print('endpoint-url: The endpoint URL that should point to IBM Cloud')
print('apikey: IBM Cloud IAM apikey that will be used to retrieve an access token')
print('instance-guid: GUID of an IBM Cloud Monitoring with monitoring instance')
sys.exit(1)
if len(sys.argv) != 4:
usage()
URL = sys.argv[1]
APIKEY = sys.argv[2]
GUID = sys.argv[3]
# Name of the dashboard that you want to delete
DASHBOARD_NAME = "Nginx production"
# Instantiate the client
ibm_headers = IbmAuthHelper.get_headers(URL, APIKEY, GUID)
sdclient = SdMonitorClient(sdc_url=URL, custom_headers=ibm_headers)
# Show the list of dashboards
ok, res = sdclient.get_dashboards()
# Loop through all fetched dashboards
for dashboard in res[1]['dashboards']:
# Delete dashboard if it matches the pattern (one or many)
if DASHBOARD_NAME in dashboard['name']:
print("Deleting " + dashboard['name'])
res = sdclient.delete_dashboard(dashboard)
Supprimer un tableau de bord d'une équipe
Le code suivant montre la structure d'un script Python permettant de supprimer un tableau de bord d'une équipe spécifique.
#!/usr/bin/env python3
import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), '..'))
from sdcclient import SdMonitorClient
# Parse arguments.
def usage():
print('usage: %s <endpoint-url> <sysdig_token>' % sys.argv[0])
print('endpoint-url: The endpoint URL that should point to IBM Cloud')
print('sysdig_token: Sysdig token for the team')
sys.exit(1)
if len(sys.argv) != 3:
usage()
URL = sys.argv[1]
# Set to the Sysdig token of the team
SYSDIG_TOKEN = sys.argv[2]
sdclient = SdMonitorClient(token=SYSDIG_TOKEN,sdc_url=URL)
# Show the list of dashboards
ok, res = sdclient.get_dashboards()
# Loop through all fetched dashboards
for dashboard in res[1]['dashboards']:
# Delete dashboard if it matches the pattern (one or many)
if DASHBOARD_NAME in dashboard['name']:
print("Deleting " + dashboard['name'])
res = sdclient.delete_dashboard(dashboard)
Téléchargez des tableaux de bord personnalisés
Vous pouvez utiliser Python pour télécharger des tableaux de bord personnalisés.
Lorsque vous téléchargez des tableaux de bord, vous ne téléchargez que des tableaux de bord personnalisés.
Téléchargez des tableaux de bord personnalisés dans l'équipe par défaut
Le code suivant montre la structure d'un script Python permettant de télécharger un tableau de bord personnalisé à partir de l'équipe par défaut.
#!/usr/bin/env python3
import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), '..'))
from sdcclient import IbmAuthHelper, SdMonitorClient
# Parse arguments.
def usage():
print('usage: %s <endpoint-url> <apikey> <instance-guid>' % sys.argv[0])
print('endpoint-url: The endpoint URL that should point to IBM Cloud')
print('apikey: IBM Cloud IAM apikey that will be used to retrieve an access token')
print('instance-guid: GUID of an IBM Cloud Monitoring with monitoring instance')
sys.exit(1)
if len(sys.argv) != 4:
usage()
def zipdir(path, ziph):
# ziph is zipfile handle
for root, dirs, files in os.walk(path):
for file in files:
ziph.write(os.path.join(root, file))
def cleanup_dir(path):
if os.path.exists(path) == False:
return
if os.path.isdir(path) == False:
print('Provided path is not a directory')
sys.exit(-1)
for file in os.listdir(path):
file_path = os.path.join(path, file)
try:
if os.path.isfile(file_path):
os.unlink(file_path)
else:
print('Cannot clean the provided directory due to delete failure on %s' % file_path)
except Exception as e:
print(e)
os.rmdir(path)
sysdig_dashboard_dir = 'sysdig-dashboard-dir'
URL = sys.argv[1]
APIKEY = sys.argv[2]
GUID = sys.argv[3]
# Instantiate the client
ibm_headers = IbmAuthHelper.get_headers(URL, APIKEY, GUID)
sdclient = SdMonitorClient(sdc_url=URL, custom_headers=ibm_headers)
ok, res = sdclient.get_dashboards()
if not ok:
print(res)
sys.exit(1)
# Creating sysdig dashboard directory to store dashboards
if not os.path.exists(sysdig_dashboard_dir):
os.makedirs(sysdig_dashboard_dir)
for db in res['dashboards']:
sdclient.save_dashboard_to_file(db, os.path.join(sysdig_dashboard_dir, str(db['id'])))
print("Name: %s, # Charts: %d" % (db['name'], len(db['widgets'])))
Téléchargez des tableaux de bord personnalisés dans une équipe
Le code suivant montre la structure d'unPython script pour télécharger un tableau de bord personnalisé d’une équipe spécifique.
#!/usr/bin/env python3
import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), '..'))
from sdcclient import SdMonitorClient
# Parse arguments.
def usage():
print('usage: %s <endpoint-url> <sysdig_token>' % sys.argv[0])
print('endpoint-url: The endpoint URL that should point to IBM Cloud')
print('sysdig_token: Sysdig token for the team')
sys.exit(1)
if len(sys.argv) != 3:
usage()
URL = sys.argv[1]
# Set to the Sysdig token of the team
SYSDIG_TOKEN = sys.argv[2]
def zipdir(path, ziph):
# ziph is zipfile handle
for root, dirs, files in os.walk(path):
for file in files:
ziph.write(os.path.join(root, file))
def cleanup_dir(path):
if os.path.exists(path) == False:
return
if os.path.isdir(path) == False:
print('Provided path is not a directory')
sys.exit(-1)
for file in os.listdir(path):
file_path = os.path.join(path, file)
try:
if os.path.isfile(file_path):
os.unlink(file_path)
else:
print('Cannot clean the provided directory due to delete failure on %s' % file_path)
except Exception as e:
print(e)
os.rmdir(path)
sysdig_dashboard_dir = 'sysdig-dashboard-dir'
sdclient = SdMonitorClient(token=SYSDIG_TOKEN,sdc_url=URL)
ok, res = sdclient.get_dashboards()
if not ok:
print(res)
sys.exit(1)
# Creating sysdig dashboard directory to store dashboards
if not os.path.exists(sysdig_dashboard_dir):
os.makedirs(sysdig_dashboard_dir)
for db in res['dashboards']:
sdclient.save_dashboard_to_file(db, os.path.join(sysdig_dashboard_dir, str(db['id'])))
print("Name: %s, # Charts: %d" % (db['name'], len(db['widgets'])))