{"id":75653,"date":"2024-01-02T19:01:38","date_gmt":"2024-01-02T18:01:38","guid":{"rendered":"https:\/\/kinsta.com\/it\/?p=75653&preview=true&preview_id=75653"},"modified":"2026-02-24T12:06:40","modified_gmt":"2026-02-24T11:06:40","slug":"log-server-api","status":"publish","type":"post","link":"https:\/\/kinsta.com\/it\/blog\/log-server-api\/","title":{"rendered":"Come recuperare i log del server (errori, accessi e prestazioni della cache) con l’API di Kinsta"},"content":{"rendered":"

I log sono molto utili per la risoluzione dei problemi e il debug dei siti WordPress. Su Kinsta \u00e8 possibile accedere a tre tipi di log<\/a>: log degli errori, log di kinsta-cache-perf (prestazioni della cache) e log degli accessi.<\/p>\n

Accedere ai log attraverso il cruscotto di MyKinsta<\/a> \u00e8 semplice: basta andare su Siti WordPress<\/strong>, selezionare il sito desiderato e cliccare sulla scheda Log<\/strong> per aprire la pagina di visualizzazione dei log<\/strong>.<\/p>\n

Ora, grazie all’API di Kinsta<\/a>, \u00e8 possibile accedere a questi log in modo programmatico. Mentre le agenzie possono creare interfacce personalizzate per accedere ai log, i team pi\u00f9 grandi possono sfruttare strumenti come Slack per creare uno Slackbot personalizzato. Questo bot pu\u00f2 interagire con l’API attraverso i comandi Slash, semplificando il recupero e la gestione dei log.<\/p>\n

Questa guida spiega come funziona l’endpoint dei log disponibile attraverso l’API, i suoi potenziali utilizzi e come accedere a questi log in un ambiente Slack.<\/p>\n

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

L’API di Kinsta<\/h2>\n

L’API di Kinsta<\/a> \u00e8 un potente strumento che permette di interagire programmaticamente con i servizi di Kinsta come i siti WordPress ospitati. Pu\u00f2 aiutare ad automatizzare diverse attivit\u00e0 legate alla gestione di WordPress, tra cui la creazione di un sito, il recupero di informazioni sul sito, lo stato di un sito<\/a>, la consultazione e il ripristino dei backup, l’acquisizione dei log del sito e altro ancora.<\/p>\n

Per utilizzare le API di Kinsta, \u00e8 necessario avere un account con almeno un sito WordPress<\/a>, un’applicazione<\/a> o un database<\/a> in MyKinsta. \u00c8 anche necessario generare una chiave API per autenticarsi e accedere al proprio account.<\/p>\n

Per generare una chiave API:<\/p>\n

    \n
  1. Andiamo alla dashboard di MyKinsta.<\/li>\n
  2. Andiamo alla pagina delle chiavi API<\/strong> (Nome<\/strong> > Impostazioni azienda<\/strong> > Chiavi API<\/strong>).<\/li>\n
  3. Clicchiamo su Crea chiave API<\/strong>.<\/li>\n
  4. Scegliamo una scadenza o impostiamo una data di inizio personalizzata e un numero di ore di scadenza della chiave.<\/li>\n
  5. Assegniamo alla chiave un nome univoco.<\/li>\n
  6. Clicchiamo su Genera<\/strong>.<\/li>\n<\/ol>\n

    Dopo aver creato una chiave API, copiamola e conserviamola in un luogo sicuro (noi consigliamo l’uso di un gestore di password<\/a>), poich\u00e9 \u00e8 l’unica volta<\/strong> che verr\u00e0 rivelata all’interno di MyKinsta. \u00c8 possibile generare pi\u00f9 chiavi API, che saranno elencate nella pagina delle chiavi API<\/strong>. Se si desidera revocare una chiave API, basta cliccare sul pulsante Revoca<\/strong> accanto al nome e alla data di scadenza.<\/p>\n

    Accedere ai log del server con l’API di Kinsta<\/h2>\n

    Per accedere ai log con l’API di Kinsta, \u00e8 necessario specificare l’ID dell’ambiente del sito, il tipo di log che si desidera recuperare (ad esempio error<\/code>, access<\/code>, o kinsta-cache-perf<\/code>) e il numero di righe di log da recuperare.<\/p>\n

    Esploriamo questo endpoint e successivamente integriamolo in uno Slackbot in modo da poter utilizzare i comandi Slash di Slack<\/a> per interagire con l’API di Kinsta.<\/p>\n

    Possiamo ottenere l’ID dell’ambiente del sito in modo programmatico attraverso l’endpoint get site environment<\/a>, che restituisce i dettagli dell’ambiente del sito, compreso il suo 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
    Una volta ottenuto l’ID dell’ambiente del sito, inviamo una richiesta GET<\/code> a \/sites\/environments\/{env_id}\/logs?file_name=error&lines=100<\/code>:<\/p>\n
    curl -i -X GET \\\n  'https:\/\/api.kinsta.com\/v2\/sites\/environments\/{env_id}\/logs?file_name=access&lines=100' \\\n  -H 'Authorization: Bearer '<\/code><\/pre>\n
    Questo restituir\u00e0 una stringa con il numero di righe di log specificato:<\/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
    Potremo quindi formattare l’output in modo da separare ogni riga con l’interruzione di riga n<\/code>. Ad esempio, con JavaScript<\/a>, possiamo utilizzare il metodo 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
    Implementare i comandi Slash di Slack per recuperare i log del server con l’API Kinsta<\/h2>\n
    In una recente guida \u00e8 stato spiegato il processo di creazione di uno Slackbot utilizzando Node.js e l’API Kinsta<\/a> per la gestione del sito. La guida illustrava la creazione di uno Slackbot e l’interazione con l’API Kinsta tramite un’applicazione Node.js<\/a> ospitata sulla nostra piattaforma di Hosting di Applicazioni<\/a>.<\/p>\n
    Per questa guida, creeremo un nuovo comando Slackbot per ottenere gli endpoint di log del sito. Per seguire questa guida, \u00e8 necessario consultare la guida precedente per capire come funziona l’applicazione Node.js<\/a> e come configurare uno Slackbot personalizzato<\/a>.<\/p>\n
    Una volta completata, potremo procedere a clonare il nostro progetto iniziale con Git:<\/p>\n
      \n
    1. Navighiamo nella directory che preferiamo per archiviare il codice ed eseguiamo il comando qui sotto nel terminale:\n
      git clone -b tutorial-1 --single-branch https:\/\/github.com\/olawanlejoel\/SlackBot-KinstaAPI.git<\/code><\/pre>\n<\/li>\n
    2. Spostiamoci nella cartella del progetto e installiamo tutte le dipendenze necessarie:\n
      cd SlackBot-KinstaAPI\nnpm install<\/code><\/pre>\n<\/li>\n<\/ol>\n
      Creare comandi slash su Slack per recuperare i log del server<\/h3>\n
      Nella precedente guida su API di Kinsta e Slackbot<\/a>, abbiamo creato cinque comandi slash per gestire quanto segue:<\/p>\n