{"id":21670860,"url":"https://github.com/tkuchiki/mackerel-plugin-linux-proc-stats","last_synced_at":"2025-04-12T02:43:19.696Z","repository":{"id":57587118,"uuid":"48176833","full_name":"tkuchiki/mackerel-plugin-linux-proc-stats","owner":"tkuchiki","description":"Linux processes metrics plugin for mackerel.io agent.","archived":false,"fork":false,"pushed_at":"2016-06-19T08:11:07.000Z","size":14,"stargazers_count":13,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-25T22:21:57.277Z","etag":null,"topics":["golang","linux","mackerel","mackerel-plugin","plugins","process","stats"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tkuchiki.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-12-17T13:47:49.000Z","updated_at":"2021-10-26T11:32:52.000Z","dependencies_parsed_at":"2022-09-26T19:33:19.949Z","dependency_job_id":null,"html_url":"https://github.com/tkuchiki/mackerel-plugin-linux-proc-stats","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tkuchiki%2Fmackerel-plugin-linux-proc-stats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tkuchiki%2Fmackerel-plugin-linux-proc-stats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tkuchiki%2Fmackerel-plugin-linux-proc-stats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tkuchiki%2Fmackerel-plugin-linux-proc-stats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tkuchiki","download_url":"https://codeload.github.com/tkuchiki/mackerel-plugin-linux-proc-stats/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248507711,"owners_count":21115662,"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","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":["golang","linux","mackerel","mackerel-plugin","plugins","process","stats"],"created_at":"2024-11-25T12:36:57.713Z","updated_at":"2025-04-12T02:43:19.676Z","avatar_url":"https://github.com/tkuchiki.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mackerel-plugin-linux-proc-stats\nLinux processes metrics plugin for mackerel.io agent.\n\n## Synopsis\n\n```shell\nmackerel-plugin-linux-proc-stats -pid=\u003cpid\u003e|-pidfile=\u003cpidfile\u003e|-process-pattern=\u003cprocess pattern\u003e [-metric-key-prefix=\u003cmetric-key-prefix\u003e] [-tempfile=\u003ctempfile\u003e] [-follow-child-processes] [-include-dead-children=0]\n```\n\n```shell\n$ ./mackerel-plugin-linux-proc-stats --help\nUsage of ./mackerel-plugin-linux-proc-stats:\n  -follow-child-processes\n        Follow child processes\n  -include-dead-children\n        Include dead kids in cpu sum (default true)\n  -metric-key-prefix string\n        Metric key prefix\n  -pid string\n        PID\n  -pidfile string\n        PID file\n  -process-pattern string\n        Match a command against this pattern\n  -tempfile string\n        Temp file name\n  -version\n        Version\n```\n\n## Requirements\n\n- [getconf](http://linux.die.net/man/1/getconf)\n\n## Example of mackerel-agent.conf\n\n```\n[plugin.metrics.linux_proc_stats]\ncommand = \"/path/to/mackerel-plugin-linux-proc-stats -pidfile /var/run/nginx.pid -follow-child-processes\"\n```\n\n```\n[plugin.metrics.linux_proc_stats]\ncommand = \"/path/to/mackerel-plugin-linux-proc-stats -pidfile /var/run/mackerel-agent.pid\"\n```\n\n```\n[plugin.metrics.linux_proc_stats]\ncommand = \"/path/to/mackerel-plugin-linux-proc-stats -process-pattern 'nginx: master process'\"\n```\n\n## Example\n\nRunning threads.\n\n```shell\n$ ./mackerel-plugin-linux-proc-stats -pidfile /var/run/mackerel-agent.pid\nmackerel-agent_process.memory.vsize     812974080.000000        1458808344\nmackerel-agent_process.memory.rss       10448896.000000 1458808344\nmackerel-agent_process.num.running      0.000000        1458808344\nmackerel-agent_process.num.processes    1.000000        1458808344\nmackerel-agent_process.num.threads      26.000000       1458808344\nmackerel-agent_process.cpu.usage        0.083986        1458808344\n```\n\nOnly master process.\n\n```shell\n$ ./mackerel-plugin-linux-proc-stats -pidfile /var/run/nginx.pid\nnginx_process.cpu.usage 0.000000        1458808477\nnginx_process.memory.vsize      107450368.000000        1458808477\nnginx_process.memory.rss        3399680.000000  1458808477\nnginx_process.num.running       0.000000        1458808477\nnginx_process.num.processes     1.000000        1458808477\nnginx_process.num.threads       1.000000        1458808477\n```\n\nMaster process and worker processes.\n\n```shell\n$ ./mackerel-plugin-linux-proc-stats -pidfile /var/run/nginx.pid -follow-child-processes\nnginx_process.num.running       0.000000        1458808496\nnginx_process.num.processes     2.000000        1458808496\nnginx_process.num.threads       2.000000        1458808496\nnginx_process.cpu.usage 0.000095        1458808496\nnginx_process.memory.vsize      215269376.000000        1458808496\nnginx_process.memory.rss        7966720.000000  1458808496\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftkuchiki%2Fmackerel-plugin-linux-proc-stats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftkuchiki%2Fmackerel-plugin-linux-proc-stats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftkuchiki%2Fmackerel-plugin-linux-proc-stats/lists"}