{"id":13400588,"url":"https://github.com/google/cadvisor","last_synced_at":"2025-05-12T15:04:03.735Z","repository":{"id":17782143,"uuid":"20653934","full_name":"google/cadvisor","owner":"google","description":"Analyzes resource usage and performance characteristics of running containers.","archived":false,"fork":false,"pushed_at":"2025-03-18T16:46:55.000Z","size":52783,"stargazers_count":17893,"open_issues_count":809,"forks_count":2372,"subscribers_count":382,"default_branch":"master","last_synced_at":"2025-05-05T13:58:13.443Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/google.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-06-09T16:36:33.000Z","updated_at":"2025-05-05T11:49:27.000Z","dependencies_parsed_at":"2023-02-13T00:45:37.397Z","dependency_job_id":"8a7dedf6-ab24-4247-b2a8-e1ad50a8757f","html_url":"https://github.com/google/cadvisor","commit_stats":{"total_commits":2070,"total_committers":361,"mean_commits":5.734072022160665,"dds":0.8623188405797102,"last_synced_commit":"bf2a7fee4170e418e7ac774af7679257fe26dc69"},"previous_names":[],"tags_count":145,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fcadvisor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fcadvisor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fcadvisor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fcadvisor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/google","download_url":"https://codeload.github.com/google/cadvisor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253762660,"owners_count":21960415,"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":[],"created_at":"2024-07-30T19:00:53.625Z","updated_at":"2025-05-12T15:04:03.686Z","avatar_url":"https://github.com/google.png","language":"Go","readme":"![cAdvisor](logo.png \"cAdvisor\")\n\n![test status](https://github.com/google/cadvisor/workflows/Test/badge.svg)\n\ncAdvisor (Container Advisor) provides container users an understanding of the resource usage and performance characteristics of their running containers. It is a running daemon that collects, aggregates, processes, and exports information about running containers. Specifically, for each container it keeps resource isolation parameters, historical resource usage, histograms of complete historical resource usage and network statistics. This data is exported by container and machine-wide.\n\ncAdvisor has native support for [Docker](https://github.com/docker/docker) containers and should support just about any other container type out of the box. We strive for support across the board so feel free to open an issue if that is not the case. cAdvisor's container abstraction is based on [lmctfy](https://github.com/google/lmctfy)'s so containers are inherently nested hierarchically.\n\n#### Quick Start: Running cAdvisor in a Docker Container\n\nTo quickly tryout cAdvisor on your machine with Docker, we have a Docker image that includes everything you need to get started. You can run a single cAdvisor to monitor the whole machine. Simply run:\n\n```\nVERSION=v0.49.1 # use the latest release version from https://github.com/google/cadvisor/releases\nsudo docker run \\\n  --volume=/:/rootfs:ro \\\n  --volume=/var/run:/var/run:ro \\\n  --volume=/sys:/sys:ro \\\n  --volume=/var/lib/docker/:/var/lib/docker:ro \\\n  --volume=/dev/disk/:/dev/disk:ro \\\n  --publish=8080:8080 \\\n  --detach=true \\\n  --name=cadvisor \\\n  --privileged \\\n  --device=/dev/kmsg \\\n  gcr.io/cadvisor/cadvisor:$VERSION\n```\n\ncAdvisor is now running (in the background) on `http://localhost:8080`. The setup includes directories with Docker state cAdvisor needs to observe.\n\n**Note**: If you're running on CentOS, Fedora, or RHEL (or are using LXC), take a look at our [running instructions](docs/running.md).\n\nWe have detailed [instructions](docs/running.md#standalone) on running cAdvisor standalone outside of Docker. cAdvisor [running options](docs/runtime_options.md) may also be interesting for advanced usecases. If you want to build your own cAdvisor Docker image, see our [deployment](docs/deploy.md) page.\n\nFor [Kubernetes](https://github.com/kubernetes/kubernetes) users, cAdvisor can be run as a daemonset. See the [instructions](deploy/kubernetes) for how to get started, and for how to [kustomize](https://github.com/kubernetes-sigs/kustomize#kustomize) it to fit your needs.\n\n## Building and Testing\n\nSee the more detailed instructions in the [build page](docs/development/build.md). This includes instructions for building and deploying the cAdvisor Docker image.\n\n## Exporting stats\n\ncAdvisor supports exporting stats to various storage plugins. See the [documentation](docs/storage/README.md) for more details and examples.\n\n## Web UI\n\ncAdvisor exposes a web UI at its port:\n\n`http://\u003chostname\u003e:\u003cport\u003e/`\n\nSee the [documentation](docs/web.md) for more details.\n\n## Remote REST API \u0026 Clients\n\ncAdvisor exposes its raw and processed stats via a versioned remote REST API. See the API's [documentation](docs/api.md) for more information.\n\nThere is also an official Go client implementation in the [client](client/) directory. See the [documentation](docs/clients.md) for more information.\n\n## Roadmap\n\ncAdvisor aims to improve the resource usage and performance characteristics of running containers. Today, we gather and expose this information to users. In our roadmap:\n\n- Advise on the performance of a container (e.g.: when it is being negatively affected by another, when it is not receiving the resources it requires, etc).\n- Auto-tune the performance of the container based on previous advise.\n- Provide usage prediction to cluster schedulers and orchestration layers.\n\n## Community\n\nContributions, questions, and comments are all welcomed and encouraged! cAdvisor developers hang out on [Slack](https://kubernetes.slack.com) in the #sig-node channel (get an invitation [here](http://slack.kubernetes.io/)). We also have [discuss.kubernetes.io](https://discuss.kubernetes.io/).\n\nPlease reach out and get involved in the project, we're actively looking for more contributors to bring on board!\n\n### Core Team\n* [@bobbypage, Google](https://github.com/bobbypage)\n* [@iwankgb, Independent](https://github.com/iwankgb)\n* [@creatone, Independent](https://github.com/creatone)\n* [@dims, VMWare](https://github.com/dims)\n* [@mrunalp, RedHat](https://github.com/mrunalp)\n\n### Frequent Collaborators\n* [@haircommander, RedHat](https://github.com/haircommander)\n\n### Emeritus\n* [@dashpole, Google](https://github.com/dashpole)\n* [@dchen1107, Google](https://github.com/dchen1107)\n* [@derekwaynecarr, RedHat](https://github.com/derekwaynecarr)\n","funding_links":[],"categories":["Go","Container Operations","Observability \u0026 Monitoring","Misc","Cloud-Computing","3. Collect","Collecting data into InfluxDB","others","By Industry","Monitoring","Content","Container tooling","Metrics","Monitoring \u0026 Logging","Industrial Materials","Containers","🏗相关开源项目","By Language","Docker","Container registries","Software","Application Recommendation","Monitor","Other","容器管理与运维 (Container Operations)"],"sub_categories":["Monitoring","Metrics","Projects","Data Science","Monitoring \u0026 Logging","Tools","Threat modelling","监控工具","Go","Monitoring \u0026 Status Pages","🛠️ DevOps","监控与日志 (Monitoring \u0026 Logging)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle%2Fcadvisor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoogle%2Fcadvisor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle%2Fcadvisor/lists"}