Aller au contenu principal

Amazon FSx

Contenu du Pack​

Modèles​

Le connecteur de supervision Centreon Amazon FSx apporte 1 modèle d'hôte :

  • Cloud-Aws-Fsx-custom

Il apporte les Modèles de Service suivants :

Service AliasService TemplateDefault
Fsx-DataUsageCloud-Aws-Fsx-Datausage-ApiX
Fsx-FreespaceCloud-Aws-Fsx-Freespace-ApiX

Règles de découverte​

Rule nameDescription
Cloud-Aws-Fsx-Api-HostDiscoveryDiscover FSx Filesystems from your Cloudwatch endpoint

Métriques & statuts collectés​

Metric NameUnit
fsx.data.read.bytesB
fsx.data.read.bytespersecondB/s
fsx.data.write.bytesB
fsx.data.write.bytespersecondB/s
fsx.data.io.read.countcount
fsx.data.io.read.persecondpersecond
fsx.data.io.write.countcount
fsx.data.io.write.persecondpersecond
fsx.metadata.ops.bytesB
fsx.metadata.ops.bytespersecondB/s

Prérequis​

Configurer un compte de service ayant les autorisations suivantes :

AWS PrivilegeDescription
fsx:DescribeFileSystemsDisplay FSx instances & details
cloudwatch:getMetricStatisticsGet metrics from the AWS/FSx namespace on Cloudwatch

Installation​

  1. Installer le Plugin Centreon sur tous les collecteurs Centreon devant superviser des resources Amazon FSx:
yum install centreon-plugin-Cloud-Aws-Fsx-Api
  1. Sur l'interface Web de Centreon, installer le connecteur de supervision Amazon FSx depuis la page Configuration > Packs de plugins.

Configuration​

Hôte​

  • Ajoutez un Hôte à Centreon depuis la page Configuration > Hôtes

  • Complétez les champs Nom,Alias & IP Address / DNS correspondant à votre serveur Amazon FSx.

  • Appliquez le Modèle d'Hôte Cloud-Aws-Fsx-custom

  • Une fois le modèle appliqué, renseignez les macros correspondantes. Attention, certaines macros sont obligatoires ("mandatory").

MandatoryNomDescription
XAWSSECRETKEYAWS Secret key of your IAM role. Password checkbox must be checked
XAWSACESSKEYAWS Access key of your IAM role. Password checkbox must be checked
XAWSREGIONRegion where the instance is running
XAWSCUSTOMMODECustom mode to get metrics, 'awscli' is the default, you can also use 'paws' perl library
PROXYURLConfigure proxy URL
EXTRAOPTIONSAny extra option you may want to add to every command_line (eg. a --verbose flag)
DUMMYSTATUSHost state. Default is OK, do not modify it unless you know what you are doing
DUMMYOUTPUTHost check output. Default is 'This is a dummy check'. Customize it with your own if needed

Comment puis-je tester le Plugin et que signifient les options des commandes ?​

Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine:

/usr/lib/centreon/plugins//centreon_aws_fsx_api.pl \
--plugin=cloud::aws::fsx::plugin \
--mode=datausage \
--custommode='awscli' \
--aws-secret-key='' \
--aws-access-key='' \
--region='' \
--name='' \
--proxyurl='' \
--filter-metric='' \
--statistic='average' \
--timeframe='900' \
--period='60' \
--warning-data-write-ops='' \
--critical-data-write-ops='' \
--warning-data-read-ops='' \
--critical-data-read-ops='' \
--warning-data-write-bytes='' \
--critical-data-write-bytes='1000000000' \
--warning-data-read-bytes='' \
--critical-data-read-bytes='' \
--warning-metadata-ops-bytes='' \
--critical-metadata-ops-bytes='' \
--verbose

La commande devrait retourner un message de sortie similaire à :

OK: All FSx metrics are ok| 

Dans cet exemple, une alarme de type CRITICAL est déclenchée si le volume de données écrites en octets dépasse 1Go (--critical-data-write-bytes='1000000000').

La liste de toutes les options complémentaires et leur signification peut être affichée en ajoutant le paramètre --help à la commande:

/usr/lib/centreon/plugins//centreon_aws_fsx_api.pl \
--plugin=cloud::aws::fsx::plugin \
--mode=datausage \
--help

Tous les modes disponibles peuvent être affichés en ajoutant le paramètre --list-mode à la commande:

/usr/lib/centreon/plugins//centreon_aws_fsx_api.pl \
--plugin=cloud::aws::fsx::plugin \
--list-mode

Diagnostic des erreurs communes​

Rendez-vous sur la documentation dédiée pour le diagnostic des erreurs communes des Plugins Centreon.