signoz/README.md

182 lines
7.8 KiB
Markdown
Raw Normal View History

2021-04-20 01:28:06 +05:30
<p align="center">
2021-04-20 13:12:03 +05:30
<img src="https://res.cloudinary.com/dcv3epinx/image/upload/v1618904450/signoz-images/LogoGithub_sigfbu.svg" alt="SigNoz-logo" width="240" />
2021-01-03 17:32:59 +05:30
2021-04-20 01:28:06 +05:30
<p align="center">Monitor your applications and troubleshoot problems in your deployed applications, an open-source alternative to DataDog, New Relic, etc.</p>
</p>
2021-02-08 00:53:14 +05:30
2021-05-06 16:45:15 +05:30
<p align="center">
2022-03-08 20:56:59 +05:30
<img alt="Downloads" src="https://img.shields.io/docker/pulls/signoz/query-service?label=Downloads"> </a>
2021-05-06 16:45:15 +05:30
<img alt="GitHub issues" src="https://img.shields.io/github/issues/signoz/signoz"> </a>
2021-05-22 21:49:56 +05:30
<a href="https://twitter.com/intent/tweet?text=Monitor%20your%20applications%20and%20troubleshoot%20problems%20with%20SigNoz,%20an%20open-source%20alternative%20to%20DataDog,%20NewRelic.&url=https://signoz.io/&via=SigNozHQ&hashtags=opensource,signoz,observability">
2021-05-06 17:04:15 +05:30
<img alt="tweet" src="https://img.shields.io/twitter/url/http/shields.io.svg?style=social"> </a>
2021-05-06 16:45:15 +05:30
</p>
2021-07-25 22:35:58 +05:30
2021-07-25 22:35:21 +05:30
<h3 align="center">
<a href="https://signoz.io/docs"><b>Documentation</b></a> &bull;
2022-09-14 12:52:02 +05:30
<a href="https://github.com/SigNoz/signoz/blob/develop/README.zh-cn.md"><b>ReadMe in Chinese</b></a> &bull;
<a href="https://github.com/SigNoz/signoz/blob/develop/README.de-de.md"><b>ReadMe in German</b></a> &bull;
<a href="https://github.com/SigNoz/signoz/blob/develop/README.pt-br.md"><b>ReadMe in Portuguese</b></a> &bull;
<a href="https://signoz.io/slack"><b>Slack Community</b></a> &bull;
2021-07-25 22:35:21 +05:30
<a href="https://twitter.com/SigNozHq"><b>Twitter</b></a>
</h3>
2021-04-20 01:28:06 +05:30
##
2021-01-05 13:22:23 +05:30
2021-06-07 12:27:22 +05:30
SigNoz helps developers monitor applications and troubleshoot problems in their deployed applications. SigNoz uses distributed tracing to gain visibility into your software stack.
2021-05-06 12:39:55 +05:30
👉 You can see metrics like p99 latency, error rates for your services, external API calls and individual end points.
👉 You can find the root cause of the problem by going to the exact traces which are causing the problem and see detailed flamegraphs of individual request traces.
2021-01-05 13:22:23 +05:30
2021-08-23 20:46:40 +05:30
👉 Run aggregates on trace data to get business relevant metrics
2022-02-10 00:28:00 +05:30
![screenzy-1644432902955](https://user-images.githubusercontent.com/504541/153270713-1b2156e6-ec03-42de-975b-3c02b8ec1836.png)
2022-03-11 18:53:37 +05:30
<br />
2022-02-10 00:28:00 +05:30
![screenzy-1644432986784](https://user-images.githubusercontent.com/504541/153270725-0efb73b3-06ed-4207-bf13-9b7e2e17c4b8.png)
2022-03-11 18:53:37 +05:30
<br />
2022-03-11 18:54:28 +05:30
![screenzy-1647005040573](https://user-images.githubusercontent.com/504541/157875938-a3d57904-ea6d-4278-b929-bd1408d7f94c.png)
<br /><br />
<img align="left" src="https://signoz-public.s3.us-east-2.amazonaws.com/Contributing.svg" width="50px" />
## Join our Slack community
Come say Hi to us on [Slack](https://signoz.io/slack) 👋
2021-02-08 00:53:14 +05:30
<br /><br />
<img align="left" src="https://signoz-public.s3.us-east-2.amazonaws.com/Features.svg" width="50px" />
## Features:
2021-04-20 01:28:06 +05:30
2021-03-03 00:47:33 +05:30
- Application overview metrics like RPS, 50th/90th/99th Percentile latencies, and Error Rate
2021-01-05 13:22:23 +05:30
- Slowest endpoints in your application
- See exact request trace to figure out issues in downstream services, slow DB queries, call to 3rd party services like payment gateways, etc
2021-04-20 01:28:06 +05:30
- Filter traces by service name, operation, latency, error, tags/annotations.
2021-08-23 20:47:14 +05:30
- Run aggregates on trace data (events/spans) to get business relevant metrics. e.g. You can get error rate and 99th percentile latency of `customer_type: gold` or `deployment_version: v2` or `external_call: paypal`
2021-01-05 13:22:23 +05:30
- Unified UI for metrics and traces. No need to switch from Prometheus to Jaeger to debug issues.
<br /><br />
<img align="left" src="https://signoz-public.s3.us-east-2.amazonaws.com/WhatsCool.svg" width="50px" />
## Why SigNoz?
2021-04-20 01:28:06 +05:30
2021-05-06 12:31:14 +05:30
Being developers, we found it annoying to rely on closed source SaaS vendors for every small feature we wanted. Closed source vendors often surprise you with huge month end bills without any transparency.
We wanted to make a self-hosted & open source version of tools like DataDog, NewRelic for companies that have privacy and security concerns about having customer data going to third party services.
Being open source also gives you complete control of your configuration, sampling, uptimes. You can also build modules over SigNoz to extend business specific capabilities
### Languages supported:
2021-05-06 12:31:14 +05:30
We support [OpenTelemetry](https://opentelemetry.io) as the library which you can use to instrument your applications. So any framework and language supported by OpenTelemetry is also supported by SigNoz. Some of the main supported languages are:
- Java
- Python
- NodeJS
- Go
2022-11-16 17:17:08 +05:30
- PHP
- .NET
- Ruby
2022-11-16 17:17:08 +05:30
- Elixir
- Rust
2021-05-06 12:31:14 +05:30
You can find the complete list of languages here - https://opentelemetry.io/docs/
2021-01-24 14:01:50 +05:30
<br /><br />
<img align="left" src="https://signoz-public.s3.us-east-2.amazonaws.com/Philosophy.svg" width="50px" />
2021-01-05 13:22:23 +05:30
## Getting Started
### Deploy using Docker
2021-01-05 13:22:23 +05:30
Please follow the steps listed [here](https://signoz.io/docs/deployment/docker/) to install using docker
2021-01-03 17:32:59 +05:30
The [troubleshooting instructions](https://signoz.io/docs/deployment/troubleshooting) may be helpful if you face any issues.
2021-01-03 17:32:59 +05:30
<p>&nbsp </p>
### Deploy in Kubernetes using Helm
2021-01-03 17:32:59 +05:30
Please follow the steps listed [here](https://signoz.io/docs/deployment/helm_chart) to install using helm charts
2021-01-05 13:22:23 +05:30
<br /><br />
<img align="left" src="https://signoz-public.s3.us-east-2.amazonaws.com/UseSigNoz.svg" width="50px" />
## Comparisons to Familiar Tools
2021-07-17 19:18:41 +05:30
### SigNoz vs Prometheus
Prometheus is good if you want to do just metrics. But if you want to have a seamless experience between metrics and traces, then current experience of stitching together Prometheus & Jaeger is not great.
Our goal is to provide an integrated UI between metrics & traces - similar to what SaaS vendors like Datadog provides - and give advanced filtering and aggregation over traces, something which Jaeger currently lack.
<p>&nbsp </p>
2021-07-17 19:18:41 +05:30
### SigNoz vs Jaeger
Jaeger only does distributed tracing. SigNoz supports metrics, traces and logs - all the 3 pillars of observability.
Moreover, SigNoz has few more advanced features wrt Jaeger:
- Jaegar UI doesnt show any metrics on traces or on filtered traces
- Jaeger cant get aggregates on filtered traces. For example, p99 latency of requests which have tag - customer_type='premium'. This can be done easily on SigNoz
<br /><br />
<img align="left" src="https://signoz-public.s3.us-east-2.amazonaws.com/Contributors.svg" width="50px" />
## Contributing
We ❤️ contributions big or small. Please read [CONTRIBUTING.md](CONTRIBUTING.md) to get started with making contributions to SigNoz.
Not sure how to get started? Just ping us on `#contributing` in our [slack community](https://signoz.io/slack)
### Project maintainers
#### Backend
- [Ankit Nayan](https://github.com/ankitnayan)
- [Nityananda Gohain](https://github.com/nityanandagohain)
- [Srikanth Chekuri](https://github.com/srikanthccv)
- [Vishal Sharma](https://github.com/makeavish)
#### Frontend
- [Palash Gupta](https://github.com/palashgdev)
#### DevOps
- [Prashant Shahi](https://github.com/prashant-shahi)
<br /><br />
<img align="left" src="https://signoz-public.s3.us-east-2.amazonaws.com/DevelopingLocally.svg" width="50px" />
## Documentation
2021-04-20 01:28:06 +05:30
You can find docs at https://signoz.io/docs/. If you need any clarification or find something missing, feel free to raise a GitHub issue with the label `documentation` or reach out to us at the community slack channel.
2021-01-05 13:22:23 +05:30
<br /><br />
<img align="left" src="https://signoz-public.s3.us-east-2.amazonaws.com/Contributing.svg" width="50px" />
## Community
2021-04-20 01:28:06 +05:30
Join the [slack community](https://signoz.io/slack) to know more about distributed tracing, observability, or SigNoz and to connect with other users and contributors.
2021-01-05 13:26:44 +05:30
2021-03-03 00:47:33 +05:30
If you have any ideas, questions, or any feedback, please share on our [Github Discussions](https://github.com/SigNoz/signoz/discussions)
As always, thanks to our amazing contributors!
<a href="https://github.com/signoz/signoz/graphs/contributors">
<img src="https://contrib.rocks/image?repo=signoz/signoz" />
</a>