{"id":75237,"date":"2023-12-27T18:59:40","date_gmt":"2023-12-27T17:59:40","guid":{"rendered":"https:\/\/kinqsta.com\/fr\/?p=75237&preview=true&preview_id=75237"},"modified":"2026-02-24T12:03:49","modified_gmt":"2026-02-24T11:03:49","slug":"journaux-api-serveur","status":"publish","type":"post","link":"https:\/\/kinqsta.com\/fr\/blog\/journaux-api-serveur\/","title":{"rendered":"R\u00e9cup\u00e9rer les journaux du serveur (erreurs, acc\u00e8s et performances du cache) avec l’API Kinsta"},"content":{"rendered":"

Les journaux sont tr\u00e8s utiles pour d\u00e9panner et d\u00e9boguer les probl\u00e8mes sur vos sites WordPress. Chez Kinsta, vous pouvez acc\u00e9der \u00e0 trois types de journaux<\/a>: les journaux d’erreurs, les journaux kinsta-cache-perf (performance du cache) et les journaux d’acc\u00e8s.<\/p>\n

L’acc\u00e8s aux journaux depuis le tableau de bord MyKinsta<\/a> est simple : naviguez vers Sites WordPress<\/strong>, s\u00e9lectionnez le site d\u00e9sir\u00e9, et cliquez sur l’onglet Journaux<\/strong> pour ouvrir la page de visualisation des journaux<\/strong>.<\/p>\n

Maintenant, avec l’introduction de l’API Kinsta<\/a>, vous pouvez acc\u00e9der \u00e0 ces journaux de mani\u00e8re programmatique. En tant qu’agence, vous pouvez cr\u00e9er des interfaces personnalis\u00e9es pour acc\u00e9der aux journaux, tandis que les grandes \u00e9quipes peuvent utiliser des outils tels que Slack pour cr\u00e9er un Slackbot personnalis\u00e9. Ce robot peut interagir avec l’API par le biais de commandes Slash, ce qui simplifie la r\u00e9cup\u00e9ration et la gestion des journaux.<\/p>\n

Ce guide pr\u00e9sente le point de terminaison des journaux disponible via l’API, ses utilisations potentielles et la mani\u00e8re d’acc\u00e9der de mani\u00e8re transparente \u00e0 ces journaux dans un environnement Slack.<\/p>\n

<\/div><\/kinsta-auto-toc>\n

Comprendre l’API Kinsta<\/h2>\n

L’API Kinsta<\/a> est un outil puissant qui vous permet d’interagir avec les services Kinsta tels que les sites WordPress h\u00e9berg\u00e9s de mani\u00e8re programmatique. Il peut aider \u00e0 automatiser diverses t\u00e2ches li\u00e9es \u00e0 la gestion de WordPress, y compris la cr\u00e9ation de site, la r\u00e9cup\u00e9ration d’informations sur le site, l’obtention du statut d’un site<\/a>, la navigation et la restauration des sauvegardes, la r\u00e9cup\u00e9ration des journaux du site, et plus encore.<\/p>\n

Pour utiliser l’API de Kinsta, vous devez avoir un compte avec au moins un site WordPress<\/a>, une application<\/a> ou une base de donn\u00e9es<\/a>\u00a0dans MyKinsta. Vous devez \u00e9galement g\u00e9n\u00e9rer une cl\u00e9 API pour vous authentifier et acc\u00e9der \u00e0 votre compte.<\/p>\n

Pour g\u00e9n\u00e9rer une cl\u00e9 API :<\/p>\n

    \n
  1. Allez sur votre tableau de bord MyKinsta.<\/li>\n
  2. Naviguez jusqu’\u00e0 la page des cl\u00e9s API <\/strong>(Votre nom<\/strong> > R\u00e9glages de l’entreprise<\/strong> > Cl\u00e9s API<\/strong>).<\/li>\n
  3. Cliquez sur Cr\u00e9er une cl\u00e9 API<\/strong>.<\/li>\n
  4. Choisissez une date d’expiration ou d\u00e9finissez une date de d\u00e9but personnalis\u00e9e et un nombre d’heures pour l’expiration de la cl\u00e9.<\/li>\n
  5. Donnez un nom unique \u00e0 la cl\u00e9.<\/li>\n
  6. Cliquez sur G\u00e9n\u00e9rer<\/strong>.<\/li>\n<\/ol>\n

    Apr\u00e8s avoir cr\u00e9\u00e9 une cl\u00e9 API, copiez-la et conservez-la en lieu s\u00fbr (l’utilisation d’un gestionnaire de mots de passe<\/a> est recommand\u00e9e), car c’est la seule fois <\/strong>o\u00f9 elle sera r\u00e9v\u00e9l\u00e9e dans MyKinsta. Vous pouvez g\u00e9n\u00e9rer plusieurs cl\u00e9s API, qui seront list\u00e9es sur la page Cl\u00e9s API<\/strong>. Si vous devez r\u00e9voquer une cl\u00e9 API, cliquez sur le bouton R\u00e9voquer<\/strong> \u00e0 c\u00f4t\u00e9 de son nom et de sa date d’expiration.<\/p>\n

    Acc\u00e9der aux journaux du serveur avec l’API Kinsta<\/h2>\n

    Pour acc\u00e9der aux journaux avec l’API de Kinsta, vous devez sp\u00e9cifier l’ID de l’environnement du site, le type de journal que vous souhaitez r\u00e9cup\u00e9rer (par exemple error<\/code>, access<\/code>, ou kinsta-cache-perf<\/code>), et le nombre de lignes de journal \u00e0 r\u00e9cup\u00e9rer.<\/p>\n

    Nous allons explorer ce point de terminaison et l’int\u00e9grer plus tard dans un Slackbot afin que vous puissiez utiliser les commandes Slash de Slack<\/a> pour interagir avec l’API Kinsta.<\/p>\n

    Vous pouvez obtenir l’ID de l’environnement de votre site de mani\u00e8re programmatique via le point de terminaison get site environment<\/a>, qui renvoie des d\u00e9tails sur l’environnement de votre site, y compris son ID :<\/p>\n

    {\n  \"site\": {\n    \"environments\": [\n      {\n        \"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n        \"name\": \"first-site\",\n        \"display_name\": \"First site\",\n        \"is_blocked\": false,\n        \"id_edge_cache\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n        \"cdn_cache_id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n        \"is_premium\": false,\n        \"domains\": [\n          {\n            \"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n            \"name\": \"example.com\",\n            \"type\": \"live\"\n          }\n        ],\n        \"primaryDomain\": {\n          \"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n          \"name\": \"example.com\",\n          \"type\": \"live\"\n        },\n        \"ssh_connection\": {\n          \"ssh_port\": \"808080\",\n          \"ssh_ip\": {\n            \"external_ip\": \"1xx.1xx.1xx.1xx\"\n          }\n        },\n        \"container_info\": {\n          \"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n          \"php_engine_version\": \"php8.0\"\n        }\n      }\n    ]\n  }\n}<\/code><\/pre>\n
    Une fois que vous avez obtenu l’ID de l’environnement de votre site, vous pouvez envoyer une requ\u00eate GET<\/code> \u00e0 \/sites\/environments\/{env_id}\/logs?file_name=error&lines=100<\/code>:<\/p>\n
    curl -i -X GET \\\n  'https:\/\/api.kinqsta.com\/v2\/sites\/environments\/{env_id}\/logs?file_name=access&lines=100' \\\n  -H 'Authorization: Bearer '<\/code><\/pre>\n
    Vous obtiendrez une cha\u00eene contenant le nombre sp\u00e9cifi\u00e9 de lignes de journal :<\/p>\n
    {\n    \"environment\": {\n        \"container_info\": {\n            \"logs\": \"mysite.kinsta.cloud ::1 [07\/Dec\/2023:00:02:01 +0000] HEAD \\\"\/wp-cron.php?server_triggered_cronjob\\\" HTTP\/2.0 200 \\\"-\\\" \\\"curl\/7.68.0\\\" - \\\"\/wp-cron.php\\\" - - 230 0.017 0.018\\nmysite.kinsta.cloud ::1 [07\/Dec\/2023:00:17:01 +0000] HEAD \\\"\/wp-cron.php?server_triggered_cronjob\\\" HTTP\/2.0 200 \\\"-\\\" \\\"curl\/7.68.0\\\" - \\\"\/wp-cron.php\\\" - - 230 0.139 0.139\\nmysite.kinsta.cloud ::1 [07\/Dec\/2023:00:32:01 +0000] HEAD \\\"\/wp-cron.php?server_triggered_cronjob\\\" HTTP\/2.0 200 \\\"-\\\" \\\"curl\/7.68.0\\\" - \\\"\/wp-cron.php\\\" - - 230 0.016 0.016\\nmysite.kinsta.cloud ::1 [07\/Dec\/2023:00:47:01 +0000] HEAD \\\"\/wp-cron.php?server_triggered_cronjob\\\" HTTP\/2.0 200 \\\"-\\\" \\\"curl\/7.68.0\\\" - \\\"\/wp-cron.php\\\" - - 230 0.015 0.015\\n\"\n        }\n    }\n}<\/code><\/pre>\n
    Vous pouvez ensuite formater la sortie pour s\u00e9parer chaque ligne avec le saut de ligne n<\/code>. Par exemple, avec JavaScript<\/a>, vous pouvez utiliser la m\u00e9thode split()<\/code>:<\/p>\n
    const logsData = {\n    \"environment\": {\n        \"container_info\": {\n            \"logs\": \"string\"\n        }\n    }\n};\n\nconst logsString = logsData.environment.container_info.logs;\n\n\/\/ Splitting the logs string into an array of log entries based on the newline character '\\n'\nconst logEntries = logsString.split('\\n');\n\nconsole.log(logEntries);<\/code><\/pre>\n
    Impl\u00e9menter des commandes Slack Slash pour r\u00e9cup\u00e9rer les journaux du serveur avec l’API Kinsta<\/h2>\n
    Dans un guide r\u00e9cent, nous avons expliqu\u00e9 le processus de cr\u00e9ation d’un Slackbot \u00e0 l’aide de Node.js et de l’API Kinsta<\/a> pour la gestion du site. Le guide d\u00e9crivait la cr\u00e9ation d’un Slackbot et l’\u00e9tablissement d’une interaction avec l’API Kinsta via une application Node.js<\/a> h\u00e9berg\u00e9e sur notre plateforme d’h\u00e9bergement d’applications<\/a>.<\/p>\n
    Pour ce guide, nous allons cr\u00e9er une nouvelle commande Slack Slash pour obtenir les points de terminaison du journal de votre site. Pour suivre ce guide, lisez d’abord le guide ci-dessus pour comprendre l’application Node.js<\/a> et comment configurer votre Slackbot personnalis\u00e9<\/a>.<\/p>\n
    Une fois que vous avez termin\u00e9, vous pouvez cloner notre projet de d\u00e9part avec Git :<\/p>\n
      \n
    1. Naviguez vers votre r\u00e9pertoire pr\u00e9f\u00e9r\u00e9 pour stocker votre code et ex\u00e9cutez la commande suivante dans votre terminal :\n
      git clone -b tutorial-1 --single-branch https:\/\/github.com\/olawanlejoel\/SlackBot-KinstaAPI.git<\/code><\/pre>\n<\/li>\n
    2. D\u00e9placez-vous dans le dossier du projet et installez toutes les d\u00e9pendances n\u00e9cessaires :\n
      cd SlackBot-KinstaAPI\nnpm install<\/code><\/pre>\n<\/li>\n<\/ol>\n
      Cr\u00e9er des commandes Slash sur Slack pour r\u00e9cup\u00e9rer les journaux du serveur<\/h3>\n
      Dans le pr\u00e9c\u00e9dent guide Kinsta API Slackbot<\/a>, cinq commandes slash ont \u00e9t\u00e9 cr\u00e9\u00e9es pour g\u00e9rer les \u00e9l\u00e9ments suivants :<\/p>\n