Dans un précédent article, nous vous expliquions pourquoi passer de Google Analytics à Matomo pour votre mesure d'audience. Certains de nos clients ont décidé de franchir ce cap, et Clever Cloud les a accompagnés dans leur prise en main de la solution. À partir de cette expérience, découvrez dans cet article comment maximiser l'utilisation de notre addon Matomo sur Clever Cloud.

Sélection de la taille d'instance optimale

Dès la création de l'addon Matomo, Clever Cloud déploie trois instances (un runtime PHP, un addon MySQL et un addon Redis) optimisées pour vous. Initialement, elles sont dimensionnées au minimum pour évoluer en fonction de vos besoins, assurant ainsi une optimisation des coûts. Pour savoir si vous devez ajuster (pas exemple, si vous commencez à rencontrer des erreurs ou des ralentissements lors du lancement de certains processus), notre Grafana intégré est votre meilleur allié pour surveiller vos métriques et ajuster vos ressources en conséquence.

Un accès simplifié à vos métriques

Grâce au tableau de bord intuitif de chaque application, une vision claire de celle-ci vous est offerte. Nous avons récemment intégré une tuile de métriques à ce tableau de bord, vous permettant de suivre la consommation de RAM et de CPU en temps réel depuis la console.

Pour une analyse plus approfondie, un simple clic sur le logo Grafana de la tuile vous donne accès à toutes les métriques de votre application.

Par ailleurs, les logs de l'instance PHP de Matomo sont toujours là pour vous fournir en informations supplémentaires.

Tout sur l'auto-scalabilité

L'auto-scalabilité sur Clever Cloud est un atout majeur qui vous offre tranquillité d'esprit et une facturation flexible. Dans le cas de Matomo, cette fonctionnalité garantit une expérience fluide même en cas de forte demande. En gardant à l'esprit certaines spécificités, comme le besoin ponctuel de certaines extensions, vous pouvez tirer le meilleur parti de cette fonction.

Avantages d'activer l'auto-scalabilité sur l'instance PHP

Avec l'auto-scalabilité, utilisez Matomo de façon fluide et adaptative, même lors de pics d'activité ! Profitez de puissantes ressources à la demande, tout en ne payant que pour les secondes utilisées. Une fois les tâches intensives terminées, votre instance revient à une taille optimale, garantissant efficacité et économies. Ainsi, nul besoin de réserver une infrastructure importante pour répondre à de besoins ponctuels.

Dans quels cas désactiver l'auto-scalabilité ?

Clever Cloud fournit un service adaptable à vos besoins, vous avez l'option de limiter mais aussi de désactiver complètement l'auto-scalabilité des instances. Dans certains cas, il convient de la désactiver ponctuellement.

Matomo étant un service managé, certains de aspects de sa configuration sont inaltérables afin de garantir un fonctionnement et des performances optimales. Dans le cadre de l'amélioration continue de Matomo, nous avons intégré l'extension d'import de données depuis Google Analytics en réponse aux demandes courantes de nos clients. Cette extension, généralement utilisée pour une migration unique de Google Analytics vers Matomo, est par défaut désactivée.

Si vous activez l'extension et commencez un import de données, et que votre application scale, votre instance redémarre et redéploie alors l'application... avec les configurations par défaut. Le redémarrage va donc désactiver cette extension et tuer le processus d'import par la même occasion. Si vous décidez d'utiliser une extension apparaissant comme désactivé par défaut dans notre Matomo, nous vous conseillons la procédure suivante :

1. Désactivez l'auto-scalabilité de votre instance PHP Matomo
2. Augmentez la taille de l'instance le temps de réaliser le processus
3. Redémarrez l'instance
4. Une fois l'instance redéployée, activez l'extension dans Matomo

Voilà, vous êtes prêts à utiliser ponctuellement l'extension, qui restera activée jusqu'au prochain redémarrage du serveur.

Optimisation de la base de données MySQL de Matomo

Matomo, doté d'un addon MySQL, est conçu pour croître avec vous. Alors que la base de données est créée avec une capacité suffisante au démarrage, sachez que Matomo va rapidement exploiter son potentiel. Afin d'éviter des surprises, pourquoi ne pas configurer des alertes Grafana pour connaître le niveau de la mémoire ?

Créer des alertes

Parmi ses nombreuses fonctionnalités, Grafana permet de créer des alertes sur les métriques de votre choix. Vous trouverez ici un tuto pour vous montrer comment créer vos alertes depuis Grafana vers Slack, que vous pouvez également appliquer à d'autres points de contact comme Discord, Teams, etc.

Nous vous conseillons de laisser environ 20% d'espace disque disponible, car l'instance MySQL aura besoin de disque pour migrer.

Migrer la base de données

Bien que la scalabilité présente des spécificités pour les bases de données, Clever Cloud fournit une solution manuelle fluide et intuitive. Quand vous recevrez l'alerte, une simple connexion à la Console sur le tableau de bord de votre addon MySQL vous permettra de lancer notre outil de migration en un clic. Cette opération peut prendre de quelques secondes à quelques minutes, en fonction de la taille de la base.

💡 Astuce : incluez dans votre message d'alerte Grafana un lien direct vers l'onglet de migration. Cela vous permettra d'accéder instantanément à l'outil de migration, rendant le processus encore plus aisé.

Tirer profit de Matomo et de Clever Cloud

Bien qu'un service managé soit pré-configuré, vous avez le statut d'administrateur de Matomo et pouvez l'utiliser en tant que tel. Voici quelques exemples d'actions que vous pouvez réaliser avec Matomo et Clever Cloud.

Ajouter de nouveaux utilisateurs Matomo

Tous nos services managés utilisent le SSO Clever Cloud, vous permettant l'accès aux addons déployés à partir de vos identifiants sur la plateforme. Vous souhaitez peut-être ajouter des utilisateurs à Matomo sans leur donner accès à la plateforme.

Matomo permet d'ajouter des utilisateurs avec différents niveaux de permissions au sein de l'application. Vous pouvez les inviter par email directement depuis l'interface de Matomo. Les utilisateurs invités par cette méthode n'auront pas accès aux réglages systèmes de Matomo ou aux extensions, contrairement aux utilisateurs Clever Cloud.

Élever le niveau de permissions

Si vous avez ajouté un utilisateur depuis l'interface de Matomo, mais souhaitez à présent l'ajouter à votre organisation Clever Cloud avec la même adresse email, l'accès à Matomo lui sera refusé pour des raisons de sécurité puisque cet utilisateur existe déjà dans la base de donnée.

Pour éviter les doublons il suffit de supprimer l'utilisateur Matomo dans votre base de données.

1. Lancez l'interface PHPMyAdmin de votre addon MySQL
2. Cliquez sur le nom de votre base de données (pas le schéma)
3. Cherchez par mot-clé user et choisissez la table matomo_user
4. Supprimer l'utilisateur que vous souhaitez ajouter à l'organisation Clever Cloud

Voilà, vous pouvez à présent inviter l'utilisateur à votre organisation avec son adresse email, lui conférant ainsi des droits d'administration sur l'instance.

Mesurer l'audience de n'importe quelle application

Sur Clever Cloud, vous pouvez séparer vos environnements collaboratifs en créant des organisations auxquelles vous invitez des membres. Les organisations demeurent isolées, garantissant qu'aucun membre n'a accès aux applications et aux addons d'une organisation sans y être invité.

Matomo permet de suivre des apps auxquelles un simple script a été ajouté au head. Ainsi, même si une application est déployée au sein d'une organisation différente, Matomo offre une vue unifiée et complète de son suivi d'audience dès lors que l'application contient ce script.

Optimiser la séparation des rôles

Vous pouvez configurer une organisation dédiée à l'administrateur Matomo de votre entreprise ou de votre association. Depuis cette organisation, l'administrateur est en mesure de suivre l'audience des applications hébergées dans d'autres organisations, même si ces dernières lui sont inaccessibles.

Pour mettre en œuvre cette configuration, l'administrateur fournit simplement le script approprié à intégrer au niveau de la balise head de chaque application. Une fois intégré, les données de suivi seront visibles dans Matomo. Ce processus garantit que les développeurs n'ont pas accès à Matomo, tout en restreignant l'accès de l'administrateur Matomo aux applications.

Nouveau : Migrer ses données Google Analytics vers Matomo

Comme nous l'avons évoqué, vous pouvez maintenant vous aider de l'extension pour migrer vos données Google Analytics vers Matomo. Déterminer le bon dimensionnement de la base de données peut présenter quelques défis, en raison de l'opacité de Google Analytics concernant ses métriques.

Dans cette optique, nous vous suggérons de garder un oeil sur les métriques de la base et d'opter pour une augmentation progressive de ses capacités de stockage. Pour faciliter cette procédure, Matomo met à disposition un guide détaillé pour réaliser la migration.

Conclusion

Clever Cloud ne se contente pas de faciliter les déploiements d'applications et de services à la demande sous forme d'addons. En plus de cela nous incluons pour tous nos clients une suite suite intégrée offrant une surveillance approfondie de l'activité de vos applications et bases de données, ainsi que des capacités de mise à l'échelle automatique et adaptative.

Que vous ayez opté pour Matomo ou pour un autre de nos addons, nous restons à l'écoute des besoins de nos clients pour améliorer continuellement les services proposés. N'hésitez pas à nous faire part de vos suggestions !

Dans l'un de nos précédents blogposts, nous vous avons annoncé la sortie d'un Grafana Clever Cloud dédié à toutes nos métriques. Et si maintenant, vous souhaitez en plus recevoir une alerte lorsqu'une application est dans un état anormal ? Grafana propose un service d'alerte qui est compatible avec notre backend Warp10. À présent, voyons comment créer une alerte Slack pour Grafana en utilisant une source de données PromQL.

Grafana Notifier

Tout d'abord, avant de créer des alertes, nous devons configurer un notifier Grafana. Consultez la liste complète des notifiers Grafana supportés ici. Mais, vous ne pourrez pas configurer les notifiers qui nécessitent un accès administrateur, comme l'email ou le SMTP. Dans cet exemple, nous allons configurer un canal Slack pour recevoir toutes les alertes Grafana.

Configurer Slack

Afin de pouvoir recevoir des alertes sur Slack, Grafana demandera un webhook. Le processus pour en créer un avec slack est ici. À la fin, vous devriez obtenir un webhook entrant actif.

Copiez l'URL du webhook puis allez dans le panneau principal d'alerte (la cloche à gauche) et ajoutez un nouveau canal de notification slack. Configurez-le comme ci-dessous, dans le champ URL du webhook, dans l'application Slack. Vous pouvez définir le nom de votre choix.

Avant de valider, vous pouvez tester votre intégration sur Slack avec le bouton Test. Sans attendre, dans le canal Slack de la configuration, vous recevrez alors un message de test.

Les alertes sur Grafana

Maintenant que nous avons activé un notifier d'alerte, créons une alerte dans Grafana.

Les métriques disponibles de Clever Cloud

Nous allons commencer par l'un des modèles de tableaux que nous proposons sur Grafana. Nous avons donc déployé une application de preview sur une organisation Clever Cloud.

Pour la suite de ce post, nous allons travailler sur les métriques de average_load. Comme vous pouvez voir ci-dessous, il s'agit d'une simple requête PromQL. Cependant, elle inclut des variables personnalisées APP_ID et DEPLOY_ID qui ne sont pas prises en charge par les alertes Grafana !

Avant d'activer l'alerte, nous allons garder quelque part cette requête de graphique system.load1_per_cpu{app_id="APP_ID"}. Nous allons simplement remplacer la variable APP_ID par sa valeur, qui est disponible en haut du tableau.

Ensuite, pour ne pas perdre nos alertes personnalisées à chaque mise à jour des modèles de tableaux Clever Cloud, créez un nouveau tableau de bord.

Enregistrez-le également dans un dossier dédié qui n'est pas Clever Cloud, dans notre exemple, nous avons choisi alerting.

Enfin, dans ce nouveau tableau, créez le même graphique de load avec la requête system.load1_per_cpu{app_id="APP_ID"}. Comme vu précédemment, remplacez APP_ID par votre propre ID d'application. Pour la source de données, sélectionnez celle de PromQL.

Configurer l'alerte

A cette étape, nous avons un nouveau graphique où nous pouvons mettre en place une première alerte sur le load de notre application. Pour cela, allez dans le panneau Alerte, et configurez l'alerte en fonction du paramètre que vous souhaitez. Pour faire rapidement fonctionner une alerte, je configure la condition pour vérifier si mes métriques sont inférieures à la valeur 0.2.

Ensuite, toujours dans le panneau Alerte, ajoutez le notifier que vous avez créé dans la première section. Ici, vous pouvez personnaliser l'alerte que vous recevrez dans slack : ajout d'un message et de balises personnalisées.

Puis, une fois que vous avez configuré votre alerte, vous pouvez tester la règle avec le bouton tester la règle.

Ensuite, il ne vous reste plus qu'à attendre qu'une alerte apparaisse sur Slack ! En outre, chaque changement d'état d'alerte sera indiqué sur le graphique. Après environ cinq minutes, comme la condition d'état d'alerte était atteinte, j'ai bien obtenu deux changements d'état : un en attente et un en alerte.

Dès que l'état d'alerte se produit, un message Slack est envoyé par le notifier.

Enfin, j'aimerais retrouver un état plus "normal". Pour ce faire, je mets à jour ma condition d'alerte et la fixe à plus de 0,8, ce qui est une valeur plus classique pour un seuil d'alerte pour la métrique de load.

Instantanément (ou presque), l'état de l'alerte change et vient OK !

Juste après, Grafana envoie également un message à Slack pour mettre fin à l'issue !

Pour résumer

Désormais, vous devriez être en mesure de configurer vos propres alertes sur Slack pour Grafana ! Vous pouvez jouer avec le temps d'attente, la condition d'alerte, le moment de déclenchement, le contenu du message d'alerte, les balises, etc. En fait, tout ce dont vous avez besoin est une requête PromQL fonctionnelle. Néanmoins, n'oubliez pas que les alertes Grafana ne prennent pas en charge les variables des tableaux. En dehors de cela, vous devriez être en mesure de personnaliser l'alerte comme vous le souhaitez !

J'espère que vous apprécierez et n'hésitez pas à nous faire part de vos remarques et idées sur le produit Alerting et Metrics. Nous serons heureux de recevoir votre avis. Vous pouvez me contacter directement sur Twitter, ou à poster un commentaire dans l'aperçu des métriques.