{"id":68006,"date":"2024-01-02T18:50:37","date_gmt":"2024-01-02T17:50:37","guid":{"rendered":"https:\/\/kinsta.com\/de\/?p=68006&preview=true&preview_id=68006"},"modified":"2024-01-11T12:08:46","modified_gmt":"2024-01-11T11:08:46","slug":"server-protokolle-api","status":"publish","type":"post","link":"https:\/\/kinsta.com\/de\/blog\/server-protokolle-api\/","title":{"rendered":"Abrufen von Server-Logs (Fehler-, Zugriffs- und Cache-Leistung) mit der Kinsta-API"},"content":{"rendered":"

Logs sind sehr hilfreich bei der Fehlersuche und -behebung auf deinen WordPress-Seiten. Bei Kinsta kannst du auf drei Arten von Logs<\/a> zugreifen: Fehlerlogs, kinsta-cache-perf (Cache-Leistung) und Zugriffslogs.<\/p>\n

Der Zugriff auf die Logs \u00fcber das MyKinsta-Dashboard<\/a> ist ganz einfach: Navigiere zu WordPress-Websites<\/strong>, w\u00e4hle die gew\u00fcnschte Website aus und klicke auf die Registerkarte Logs<\/strong>, um die Seite Log Viewer<\/strong> zu \u00f6ffnen.<\/p>\n

Mit der Einf\u00fchrung der Kinsta-API<\/a> kannst du jetzt auch programmatisch auf diese Logs zugreifen. Als Agentur kannst du eigene Schnittstellen f\u00fcr den Zugriff auf die Logs erstellen, w\u00e4hrend gr\u00f6\u00dfere Teams Tools wie Slack nutzen k\u00f6nnen, um einen eigenen Slackbot zu erstellen. Dieser Bot kann \u00fcber Slash-Befehle mit der API interagieren und so das Abrufen und Verwalten von Protokollen vereinfachen.<\/p>\n

Dieser Leitfaden befasst sich mit dem \u00fcber die API verf\u00fcgbaren Log-Endpunkt, seinen potenziellen Einsatzm\u00f6glichkeiten und dem nahtlosen Zugriff auf diese Logs in einer Slack-Umgebung.<\/p>\n

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

Die Kinsta-API verstehen<\/h2>\n

Die Kinsta-API<\/a> ist ein leistungsstarkes Tool, mit dem du programmatisch mit Kinsta-Diensten wie gehosteten WordPress-Websites interagieren kannst. Sie kann dir dabei helfen, verschiedene Aufgaben im Zusammenhang mit der WordPress-Verwaltung zu automatisieren, z. B. das Erstellen von Websites, das Abrufen von Website-Informationen, das Abrufen des Status einer Website<\/a>, das Durchsuchen und Wiederherstellen von Backups, das Abrufen von Website-Logs und vieles mehr.<\/p>\n

Um die Kinsta-API zu nutzen, musst du ein Konto mit mindestens einer WordPress-Website<\/a>, -Anwendung<\/a> oder -Datenbank<\/a> in MyKinsta haben. Au\u00dferdem musst du einen API-Schl\u00fcssel erstellen, um dich zu authentifizieren und auf dein Konto zuzugreifen.<\/p>\n

So generierst du einen API-Schl\u00fcssel:<\/p>\n

    \n
  1. Gehe zu deinem MyKinsta-Dashboard.<\/li>\n
  2. Navigiere zur Seite mit den API-Schl\u00fcsseln <\/strong>(Dein Name<\/strong> > Unternehmenseinstellungen<\/strong> > API-Schl\u00fcssel<\/strong>).<\/li>\n
  3. Klicke auf API-Schl\u00fcssel generieren<\/strong>.<\/li>\n
  4. W\u00e4hle ein Ablaufdatum oder lege ein benutzerdefiniertes Startdatum und die Anzahl der Stunden fest, nach denen der Schl\u00fcssel abl\u00e4uft.<\/li>\n
  5. Gib dem Schl\u00fcssel einen eindeutigen Namen.<\/li>\n
  6. Klicke auf Generieren<\/strong>.<\/li>\n<\/ol>\n

    Nachdem du einen API-Schl\u00fcssel generiert hast, kopiere ihn und bewahre ihn an einem sicheren Ort auf (wir empfehlen die Verwendung eines Passwortmanagers<\/a>), denn dies ist das einzige<\/strong> Mal<\/strong>, dass er innerhalb von MyKinsta sichtbar ist. Du kannst mehrere API-Schl\u00fcssel erstellen, die dann auf der Seite API-Schl\u00fcssel<\/strong> aufgelistet werden. Wenn du einen API-Schl\u00fcssel widerrufen m\u00f6chtest, klicke auf die Schaltfl\u00e4che Widerrufen<\/strong> neben dem Namen und dem Ablaufdatum des Schl\u00fcssels.<\/p>\n

    Zugriff auf Serverprotokolle mit der Kinsta-API<\/h2>\n

    Um mit der Kinsta-API auf die Logs zuzugreifen, musst du die ID der Website-Umgebung, den Typ des Logs, den du abrufen m\u00f6chtest (z. B. error<\/code>, access<\/code> oder kinsta-cache-perf<\/code>), und die Anzahl der abzurufenden Log-Zeilen angeben.<\/p>\n

    Wir werden diesen Endpunkt untersuchen und ihn sp\u00e4ter in einen Slackbot integrieren, damit du die Slash-Befehle von Slack<\/a> zur Interaktion mit der Kinsta-API nutzen kannst.<\/p>\n

    Du kannst die Umgebungs-ID deiner Website programmatisch \u00fcber den Endpunkt get site environment<\/a> abrufen, der Details \u00fcber die Umgebung deiner Website, einschlie\u00dflich ihrer ID, zur\u00fcckgibt:<\/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
    Sobald du die Umgebungs-ID deiner Website kennst, kannst du eine GET<\/code> Anfrage an \/sites\/environments\/{env_id}\/logs?file_name=error&lines=100<\/code> senden:<\/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
    Diese gibt einen String mit der angegebenen Anzahl von Log-Zeilen zur\u00fcck:<\/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
    Du kannst die Ausgabe dann so formatieren, dass jede Zeile mit dem n<\/code> Zeilenumbruch getrennt wird. Mit JavaScript<\/a> kannst du zum Beispiel die Methode split()<\/code> verwenden:<\/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
    Implementierung von Slack Slash-Befehlen zum Abrufen von Server-Logs mit der Kinsta-API<\/h2>\n
    In einem k\u00fcrzlich erschienenen Leitfaden wurde erkl\u00e4rt, wie man einen Slackbot mit Node.js und der Kinsta-API<\/a> f\u00fcr die Website-Verwaltung erstellt. Der Leitfaden beschreibt die Erstellung eines Slackbots und die Interaktion mit der Kinsta-API \u00fcber eine Node.js-Anwendung<\/a>, die auf unserer Anwendungs-Hosting-Plattform<\/a> gehostet wird.<\/p>\n
    F\u00fcr diese Anleitung erstellen wir einen neuen Slack Slash-Befehl, um die Log-Endpunkte deiner Website abzurufen. Um hier mitzumachen, solltest du zuerst den obigen Leitfaden lesen, um zu verstehen, wie die Node.js-Anwendung<\/a> funktioniert und wie du deinen pers\u00f6nlichen Slackbot konfigurierst<\/a>.<\/p>\n
    Wenn du damit fertig bist, kannst du unser Startprojekt mit Git klonen:<\/p>\n
      \n
    1. Navigiere zu deinem bevorzugten Verzeichnis f\u00fcr die Speicherung deines Codes und f\u00fchre den folgenden Befehl in deinem Terminal aus:\n
      git clone -b tutorial-1 --single-branch https:\/\/github.com\/olawanlejoel\/SlackBot-KinstaAPI.git<\/code><\/pre>\n<\/li>\n
    2. Wechsle in den Projektordner und installiere alle erforderlichen Abh\u00e4ngigkeiten:\n
      cd SlackBot-KinstaAPI\nnpm install<\/code><\/pre>\n<\/li>\n<\/ol>\n
      Slash-Befehle auf Slack zum Abrufen von Server-Logs erstellen<\/h3>\n
      In der vorherigen Kinsta API Slackbot-Anleitung<\/a> wurden f\u00fcnf Slash-Befehle erstellt, um die folgenden Aufgaben zu erledigen:<\/p>\n