{"id":66171,"date":"2024-01-02T15:09:25","date_gmt":"2024-01-02T18:09:25","guid":{"rendered":"https:\/\/kinsta.com\/pt\/?p=66171&preview=true&preview_id=66171"},"modified":"2024-01-11T08:08:35","modified_gmt":"2024-01-11T11:08:35","slug":"registros-do-servidor-api","status":"publish","type":"post","link":"https:\/\/kinsta.com\/pt\/blog\/registros-do-servidor-api\/","title":{"rendered":"Recupere os Registros do Servidor (Erro, Acesso e Desempenho do Cache) Com a API da Kinsta"},"content":{"rendered":"

Os registros s\u00e3o muito \u00fateis para solucionar problemas e depurar problemas em sites WordPress. Na Kinsta, voc\u00ea pode acessar tr\u00eas tipos de registros<\/a>: Registros de erros, Registros kinsta-cache-perf (desempenho do cache) e Registros de acesso.<\/p>\n

Acessar os registros pelo painel MyKinsta<\/a> \u00e9 simples: navegue at\u00e9 Sites WordPress<\/strong>, escolha o site que deseja e clique na aba Registros<\/strong> para abrir a p\u00e1gina do Visualizador de Registros<\/strong>.<\/p>\n

Agora, com a introdu\u00e7\u00e3o da API da Kinsta<\/a>, voc\u00ea pode acessar esses registros de forma program\u00e1tica. Como ag\u00eancia, voc\u00ea pode criar interfaces personalizadas para acessar os registros, enquanto equipes maiores podem aproveitar ferramentas como o Slack para criar um Slackbot personalizado. Esse bot pode interagir com a API por meio de comandos Slash, simplificando a recupera\u00e7\u00e3o e o gerenciamento de registros.<\/p>\n

Este guia detalha o endpoint de registros dispon\u00edvel atrav\u00e9s da API, explora seus usos potenciais e ensina como acessar esses registros de maneira pr\u00e1tica em um ambiente Slack.<\/p>\n

\u00a0<\/p>\n

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

Entendendo a API da Kinsta<\/h2>\n

A API da Kinsta<\/a> \u00e9 uma ferramenta poderosa que possibilita a intera\u00e7\u00e3o program\u00e1tica com os servi\u00e7os da Kinsta, como sites WordPress hospedados. Ela facilita a automa\u00e7\u00e3o de diversas tarefas ligadas \u00e0 gest\u00e3o do WordPress, abrangendo desde a cria\u00e7\u00e3o de sites, recupera\u00e7\u00e3o de informa\u00e7\u00f5es do site, verifica\u00e7\u00e3o do status de um site<\/a>, at\u00e9 a navega\u00e7\u00e3o e restaura\u00e7\u00e3o de backups e a obten\u00e7\u00e3o de registros do site, entre outras funcionalidades.<\/p>\n

Para usar a API da Kinsta, voc\u00ea deve ter uma conta com pelo menos um site<\/a>, aplicativo<\/a> ou banco de dados<\/a> WordPress no MyKinsta. Voc\u00ea tamb\u00e9m precisa gerar uma chave API para autenticar e acessar sua conta.<\/p>\n

Para gerar uma chave API:<\/p>\n

    \n
  1. V\u00e1 para o painel MyKinsta.<\/li>\n
  2. Navegue at\u00e9 a p\u00e1gina Chaves API <\/strong>(Seu nome<\/strong> > Configura\u00e7\u00f5es da empresa<\/strong> > Chaves API<\/strong>).<\/li>\n
  3. Clique em Criar chave<\/strong> API<\/strong>.<\/li>\n
  4. Escolha uma expira\u00e7\u00e3o ou defina uma data de in\u00edcio personalizada e o n\u00famero de horas para a chave expirar.<\/li>\n
  5. D\u00ea \u00e0 chave um nome exclusivo.<\/li>\n
  6. Clique em Gerar<\/strong>.<\/li>\n<\/ol>\n

    Depois de criar uma chave API, copie e armazene em um local seguro (recomenda-se o uso de um gerenciador de senhas<\/a>), pois essa ser\u00e1 a \u00fanica vez que<\/strong> ser\u00e1 revelada no MyKinsta. Voc\u00ea pode gerar v\u00e1rias chaves API, que ser\u00e3o listadas na p\u00e1gina Chaves API<\/strong>. Se voc\u00ea precisar revogar uma chave API, clique no bot\u00e3o Revogar<\/strong>\u00a0ao lado de seu nome e data de expira\u00e7\u00e3o.<\/p>\n

    Acesso aos registros do servidor com a API da Kinsta<\/h2>\n

    Para acessar os registros com a API da Kinsta, voc\u00ea precisa especificar o ID do ambiente do site, o tipo de registro que deseja obter (por exemplo, error<\/code>, access<\/code>, ou kinsta-cache-perf<\/code>) e o n\u00famero de linhas de registro a serem recuperadas.<\/p>\n

    Vamos explorar esse endpoint<\/span> e, posteriormente, integr\u00e1-lo a um Slackbot para que voc\u00ea possa usar os comandos Slash do Slack<\/a> para interagir com a API da Kinsta.<\/p>\n

    Voc\u00ea pode obter o ID do ambiente do seu site programaticamente por meio do endpoint\u00a0get site environment<\/a>, que retorna detalhes sobre o ambiente do seu site, incluindo seu 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
    Depois de obter o ID do ambiente do seu site, voc\u00ea pode enviar uma solicita\u00e7\u00e3o GET<\/code> para \/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
    Isso resultar\u00e1 em uma String contendo o n\u00famero espec\u00edfico de linhas do registro:<\/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
    Voc\u00ea pode ent\u00e3o formatar a sa\u00edda para separar cada linha com a quebra de linha n<\/code>. Por exemplo, com JavaScript<\/a>, voc\u00ea pode usar o m\u00e9todo 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
    Implementando comandos Slack Slash para recuperar registros do servidor com a API da Kinsta<\/h2>\n
    Em um guia recente, foi explicado o processo de cria\u00e7\u00e3o de um Slackbot usando Node.js e a API da Kinsta<\/a> para gerenciamento de sites. O guia descreveu a cria\u00e7\u00e3o de um Slackbot e o estabelecimento da intera\u00e7\u00e3o com a API da Kinsta por meio de um aplicativo Node.js<\/a> hospedado em nossa plataforma de hospedagem de aplicativos<\/a>.<\/p>\n
    Para este guia, vamos criar um novo comando Slash do Slack para obter os endpoints de registro do seu site. Para acompanhar este guia, primeiro voc\u00ea deve revisar o guia acima para entender o aplicativo Node.js<\/a> e como configurar seu Slackbot personalizado<\/a>.<\/p>\n
    Depois de conclu\u00eddo, voc\u00ea pode clonar nosso projeto inicial com o Git:<\/p>\n
      \n
    1. Navegue at\u00e9 o diret\u00f3rio de sua prefer\u00eancia para armazenar seu c\u00f3digo e execute o seguinte comando no terminal:\n
      git clone -b tutorial-1 --single-branch https:\/\/github.com\/olawanlejoel\/SlackBot-KinstaAPI.git<\/code><\/pre>\n<\/li>\n
    2. V\u00e1 para a pasta do projeto e instale todas as depend\u00eancias necess\u00e1rias:\n
      cd SlackBot-KinstaAPI\nnpm install<\/code><\/pre>\n<\/li>\n<\/ol>\n
      Criando comandos Slash no Slack para recuperar registros do servidor<\/h3>\n
      No guia anterior do Slackbot da API da Kinsta<\/a>, cinco comandos slash foram criados para lidar com o seguinte:<\/p>\n