{"id":24694475,"url":"https://github.com/roadrunner-php/birddog","last_synced_at":"2025-10-09T01:31:10.433Z","repository":{"id":62404017,"uuid":"560117938","full_name":"roadrunner-php/birddog","owner":"roadrunner-php","description":"Birddog is a free tool for monitoring workers, services and jobs of a RoadRunner instance.","archived":false,"fork":false,"pushed_at":"2024-02-13T15:37:11.000Z","size":2372,"stargazers_count":35,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-01T17:03:35.298Z","etag":null,"topics":["docker","monitor","php","roadrunner"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roadrunner-php.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"roadrunner-server"}},"created_at":"2022-10-31T19:19:11.000Z","updated_at":"2024-12-29T14:30:43.000Z","dependencies_parsed_at":"2024-02-13T16:44:37.923Z","dependency_job_id":null,"html_url":"https://github.com/roadrunner-php/birddog","commit_stats":null,"previous_names":["roadrunner-php/birddog","roadrunner-server/birddog"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/roadrunner-php/birddog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roadrunner-php%2Fbirddog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roadrunner-php%2Fbirddog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roadrunner-php%2Fbirddog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roadrunner-php%2Fbirddog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roadrunner-php","download_url":"https://codeload.github.com/roadrunner-php/birddog/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roadrunner-php%2Fbirddog/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000725,"owners_count":26082895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","monitor","php","roadrunner"],"created_at":"2025-01-26T23:59:51.044Z","updated_at":"2025-10-09T01:31:09.873Z","avatar_url":"https://github.com/roadrunner-php.png","language":"PHP","funding_links":["https://github.com/sponsors/roadrunner-server"],"categories":[],"sub_categories":[],"readme":"# Birddog\n\nBirddog is a free tool for monitoring [workers](https://docs.roadrunner.dev/php-worker/rpc), services\nand [jobs](https://docs.roadrunner.dev/queues-and-jobs/overview-queues) of a RoadRunner instance.\n\n![birddog-plugins](https://user-images.githubusercontent.com/773481/200691160-314cc757-89b7-46ec-b55a-6b1b2788087b.png)\n![birddog-config](https://user-images.githubusercontent.com/773481/200691269-9383b752-0b6e-448a-aa6a-020936aeb1e5.png)\n![birddog-service-manager](https://user-images.githubusercontent.com/773481/200691288-e19fdf5a-490a-4712-90e1-79e46fc8dcc2.png)\n![birddog-metrics](https://user-images.githubusercontent.com/773481/200691355-8209cc73-e72e-4d52-a2b0-4bb567564977.png)\n\n## Installation\n\n```bash\ndocker run \\\n    -p 8080:8080 \\\n    -p 3000:3000 \\\n    --env DEFAULT_RPC_SERVER_ADDRESS=tcp://127.0.0.1:6001 \\\n    ghcr.io/roadrunner-server/birddog:latest\n```\n\nYou can also define multiple RPC servers via env variables:\n\n```bash\ndocker run \\\n    -p 8080:8080 \\\n    -p 3000:3000 \\\n    --env DEFAULT_RPC_SERVER=foo \\\n    --env RPC_SERVER_FOO=tcp://127.0.0.1:6001 \\ \n    --env RPC_SERVER_BAR=tcp://127.0.0.1:6001 \\\n    ghcr.io/roadrunner-server/birddog:latest\n```\n\nor using docker compose:\n\n```yaml\nversion: \"3.7\"\n\nservices:\n    rr-php:\n        build:\n            dockerfile: ./docker/php/Dockerfile\n        command: rr serve\n        restart: on-failure\n\n    monitor:\n        image: ghcr.io/roadrunner-server/birddog:latest\n        ports:\n            - \"8080:8080\"\n            - \"3000:3000\"\n        environment:\n            DEFAULT_RPC_SERVER_ADDRESS: tcp://rr-php:6001\n            API_URL: http://127.0.0.1:8080\n```\n\n## Configuration\n\nThere ENV variables that can be used to configure the Birddog:\n\n```dotenv\n# Birddog Websocket API URL\nWS_URL=http://127.0.0.1:8080/connection/websocket\n\n# Default RR RPC server address\n# It works only if you won't relace DEFAULT_RPC_SERVER ENV variable\nDEFAULT_RPC_SERVER_ADDRESS=tcp://127.0.0.1:6001\n\n# Default RPC server name \nDEFAULT_RPC_SERVER=foo\n\n# Servers definition\n# You can define multiple servers using the following format. Every server should start with RPC_SERVER_ prefix.\nRPC_SERVER_FOO=tcp://127.0.0.1:6001\nRPC_SERVER_BAR=tcp://127.0.0.1:6001\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froadrunner-php%2Fbirddog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froadrunner-php%2Fbirddog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froadrunner-php%2Fbirddog/lists"}