github · GitHub Actions Docs
Actions Monitoring and troubleshooting self-hosted runners - GitHub Docs
Provides methods and procedures for monitoring the health of self-hosted runners and troubleshooting common issues encountered during runner operation.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Actions Monitoring and troubleshooting self-hosted runners - GitHub Docs
Provides methods and procedures for monitoring the health of self-hosted runners and troubleshooting common issues encountered during runner operation.
When To Use
Use when you need to diagnose runner connectivity issues, monitor runner performance, or resolve errors occurring during the execution of jobs on self-hosted infrastructure.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-workflow-guide.md | A guide detailing methods for monitoring and troubleshooting self-hosted runners within GitHub Actions. | Questions about a guide detailing methods for monitoring and troubleshooting self-hosted runners within GitHub Actions. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste.text | A shell command used to check the status and connectivity of a self-hosted runner configuration. | Exact payloads, commands, or snippets shown in A shell command used to check the status and connectivity of a self-hosted runner configuration. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-2.text | A command line instruction for running the self-hosted runner configuration check with a URL and personal access token. | Exact payloads, commands, or snippets shown in A command line instruction for running the self-hosted runner configuration check with a URL and personal access token. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-3.text | A shell command sequence demonstrating how to configure a self-hosted runner while bypassing TLS verification using the GITHUB_ACTIONS_RUNNER_TLS_NO_VERIFY environment variable. | Exact payloads, commands, or snippets shown in A shell command sequence demonstrating how to configure a self-hosted runner while bypassing TLS verification using t... |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-4.text | PowerShell commands to set the GITHUB_ACTIONS_RUNNER_TLS_NO_VERIFY environment variable and configure a self-hosted runner. | Exact payloads, commands, or snippets shown in PowerShell commands to set the GITHUBACTIONSRUNNERTLSNOVERIFY environment variable and configure a self-hosted runner. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-5.text | A text representation of the systemd service file configuration for a GitHub Actions self-hosted runner. | Exact payloads, commands, or snippets shown in A text representation of the systemd service file configuration for a GitHub Actions self-hosted runner. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-6.text | A shell command using systemctl to filter and verify the running status of a GitHub Actions self-hosted runner service. | Exact payloads, commands, or snippets shown in A shell command using systemctl to filter and verify the running status of a GitHub Actions self-hosted runner service. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-7.text | A shell command used to monitor self-hosted runner service logs using journalctl. | Exact payloads, commands, or snippets shown in A shell command used to monitor self-hosted runner service logs using journalctl. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-8.text | Text logs showing the startup sequence and connection status of a GitHub Actions self-hosted runner service. | Exact payloads, commands, or snippets shown in Text logs showing the startup sequence and connection status of a GitHub Actions self-hosted runner service. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-9.text | A macOS launch agent plist file used to configure the GitHub Actions self-hosted runner as a background service. | Exact payloads, commands, or snippets shown in A macOS launch agent plist file used to configure the GitHub Actions self-hosted runner as a background service. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-10.text | A text snippet demonstrating the output of the service status command for a self-hosted GitHub Actions runner. | Exact payloads, commands, or snippets shown in A text snippet demonstrating the output of the service status command for a self-hosted GitHub Actions runner. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-11.text | The content of the Windows service file used to run a GitHub Actions self-hosted runner. | Exact payloads, commands, or snippets shown in The content of the Windows service file used to run a GitHub Actions self-hosted runner. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-12.text | A PowerShell command used to verify the current status and name of a specific GitHub Actions self-hosted runner service. | Exact payloads, commands, or snippets shown in A PowerShell command used to verify the current status and name of a specific GitHub Actions self-hosted runner service. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-13.text | A PowerShell command and its output showing the application event logs for the GitHub Actions Runner Service. | Exact payloads, commands, or snippets shown in A PowerShell command and its output showing the application event logs for the GitHub Actions Runner Service. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-14.text | A text log snippet showing self-hosted runner service information and a self-updater notification. | Exact payloads, commands, or snippets shown in A text log snippet showing self-hosted runner service information and a self-updater notification. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-15.text | A shell command used to verify the active status of the Docker service on a self-hosted runner. | Exact payloads, commands, or snippets shown in A shell command used to verify the active status of the Docker service on a self-hosted runner. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-16.text | A text log file showing a FileNotFoundException error when a self-hosted runner attempts to locate the docker command. | Exact payloads, commands, or snippets shown in A text log file showing a FileNotFoundException error when a self-hosted runner attempts to locate the docker command. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-17.text | A text log demonstrating a permission denied error when a self-hosted runner attempts to connect to the Docker unix socket. | Exact payloads, commands, or snippets shown in A text log demonstrating a permission denied error when a self-hosted runner attempts to connect to the Docker unix s... |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-18.text | A shell command used to inspect the User property of a self-hosted runner's systemd service using systemctl. | Exact payloads, commands, or snippets shown in A shell command used to inspect the User property of a self-hosted runner's systemd service using systemctl. |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-19.text | A text log demonstrating a missing input error for the java-version parameter during a GitHub Actions workflow execution on a self-hosted runner. | Exact payloads, commands, or snippets shown in A text log demonstrating a missing input error for the java-version parameter during a GitHub Actions workflow execut... |
examples/actions-how-tos-manage-runners-monitoring-and-troubleshooting-self-hoste-20.text | A command line output showing the path to the docker executable on a self-hosted runner. | Exact payloads, commands, or snippets shown in A command line output showing the path to the docker executable on a self-hosted runner. |
What This Skill Covers
-
- GitHub Actions / - How-tos / - Manage runners / - Self-hosted runners / - Monitor and troubleshoot
- Main sections:
Platform navigation,In this article,Checking access levels,Checking the status of a self-hosted runner,Troubleshooting network connectivity.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://docs.github.com/en/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot