{"id":13525457,"url":"https://github.com/linkerd/linkerd-viz","last_synced_at":"2025-04-16T14:36:27.306Z","repository":{"id":52479268,"uuid":"70079612","full_name":"linkerd/linkerd-viz","owner":"linkerd","description":"Top-line service metrics dashboard for Linkerd 1.","archived":false,"fork":false,"pushed_at":"2021-04-27T18:31:21.000Z","size":74,"stargazers_count":119,"open_issues_count":2,"forks_count":34,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-04-13T08:14:12.695Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","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/linkerd.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.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}},"created_at":"2016-10-05T16:45:59.000Z","updated_at":"2025-04-07T03:50:10.000Z","dependencies_parsed_at":"2022-09-12T02:00:27.521Z","dependency_job_id":null,"html_url":"https://github.com/linkerd/linkerd-viz","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkerd%2Flinkerd-viz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkerd%2Flinkerd-viz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkerd%2Flinkerd-viz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkerd%2Flinkerd-viz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linkerd","download_url":"https://codeload.github.com/linkerd/linkerd-viz/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249250889,"owners_count":21237961,"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-08-01T06:01:18.929Z","updated_at":"2025-04-16T14:36:27.287Z","avatar_url":"https://github.com/linkerd.png","language":"Shell","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"[![Docker Pulls](https://img.shields.io/docker/pulls/buoyantio/linkerd-viz.svg)](https://hub.docker.com/r/buoyantio/linkerd-viz/)\n\n# Upgrade Notice\n\nThis repo is for Linkerd 1. For instructions on setting up the Linkerd 2 viz\nextension, see the [Linkerd 2 documentation](https://linkerd.io/2/tasks/extensions/).\n\n# linkerd-viz\n\nDead simple monitoring for [linkerd](https://linkerd.io).\n\n![linkerd-viz screenshot](https://linkerd.io/images/linkerd-viz.png \"linkerd-viz screenshot\")\n\nlinkerd-viz is a monitoring application based on\n[Prometheus](https://prometheus.io/) and [Grafana](http://grafana.org/),\nautoconfigured to collect metrics from [linkerd](https://linkerd.io).\nlinkerd-viz currently supports [DC/OS](https://dcos.io/) and\n[Kubernetes](http://kubernetes.io/).\n\nlinkerd-viz assumes linkerd has already been deployed onto your cluster, and\nyour applications have been configured to route via linkerd. You'll also need\nto configure linkerd with the `io.l5d.prometheus` telemeter, to expose the stats\nthat are displayed by linkerd-viz. You should add this block to your linkerd\nconfiguration file:\n\n```yaml\ntelemetry:\n- kind: io.l5d.prometheus\n```\n\nFor more information on getting started with linkerd have a look at our [Getting\nStarted guides](https://linkerd.io/getting-started/).\n\n## Build Docker image\n\n```bash\ndocker build -t buoyantio/linkerd-viz .\n```\n\n## Local boot\n\n```bash\ndocker run -p 3000:3000 -p 9191:9191 buoyantio/linkerd-viz\n```\n\n## DC/OS Deploy\n\nInstall the official linkerd-viz DC/OS Universe package\n\n```bash\ndcos package install linkerd-viz\n```\n\nCustom installation\n\n```bash\ndcos marathon app add dcos/linkerd-viz.json\n```\n\nView dashboard\n\n```bash\nopen $PUBLIC_NODE:3000\n```\n\n## Kubernetes Deploy\n\n```bash\nkubectl apply -f k8s/linkerd-viz.yml\n```\n\nView dashboard\n\n```bash\nkubectl port-forward $(kubectl get po --selector=name=linkerd-viz -o jsonpath='{.items[*].metadata.name}') 3000:3000\nopen http://localhost:3000\n```\n\n## Consul Deploy\n\nFirst, examine and edit `consul/prometheus-consul.yml` to fit your ecosystem.\n\nRun the Consul agent locally:\n\n```bash\ndocker run -d --net=host consul:0.9.0 agent -bind=\u003cexternal ip\u003e -retry-join=\u003croot agent ip\u003e\n```\nfor more information see [Running Consul Agent in Client Mode](https://hub.docker.com/_/consul/).\n\nBoot `linkerd-viz` locally:\n\n```bash\ndocker run -d --net=host -p 3000:3000 -p 9191:9191 buoyantio/linkerd-viz:0.2.0 consul\n```\n\nView dashboard\n\n```bash\nopen localhost:3000\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinkerd%2Flinkerd-viz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinkerd%2Flinkerd-viz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinkerd%2Flinkerd-viz/lists"}