There are primarily 2 areas in which you can contribute in SigNoz
- Frontend ( written in Typescript, React)
- Backend - ( Query Service - written in Go)
Depending upon your area of expertise & interest, you can chose one or more to contribute. Below are detailed instructions to contribute in each area
Please note: If you want to work on an issue, please ask the maintainers to assign the issue to you before starting work on it. This would help us understand who is working on an issue and prevent duplicate work. 🙏🏻
If you just raise a PR, without the corresponding issue being assigned to you - it may not be accepted.
Need to update https://github.com/SigNoz/signoz/tree/main/frontend
-
git clone https://github.com/SigNoz/signoz.git && cd signoz
-
comment out frontend service section at
deploy/docker/clickhouse-setup/docker-compose.yaml#L62
-
run
cd deploy
to move to deploy directory -
Install signoz locally without the frontend
- Add below configuration to query-service section at
docker/clickhouse-setup/docker-compose.yaml#L38
ports: - "8080:8080"
- If you are using x86_64 processors (All Intel/AMD processors) run
sudo docker-compose -f docker/clickhouse-setup/docker-compose.yaml up -d
- If you are on arm64 processors (Apple M1 Macbooks) run
sudo docker-compose -f docker/clickhouse-setup/docker-compose.arm.yaml up -d
- Add below configuration to query-service section at
-
cd ../frontend
and change baseURL tohttp://localhost:8080
in filesrc/constants/env.ts
-
yarn install
-
yarn dev
Notes for Maintainers/Contributors who will change Line Numbers of Frontend & Query-Section. Please Update Line Numbers in
./scripts/commentLinesForSetup.sh
If you don't want to install SigNoz backend just for doing frontend development, we can provide you with test environments which you can use as the backend. Please ping us in #contributing channel in our slack community and we will DM you with <test environment URL>
git clone https://github.com/SigNoz/signoz.git && cd signoz/frontend
- Create a file
.env
withFRONTEND_API_ENDPOINT=<test environment URL>
yarn install
yarn dev
Frontend should now be accessible at http://localhost:3301/application
Need to update https://github.com/SigNoz/signoz/tree/main/pkg/query-service
- git clone https://github.com/SigNoz/signoz.git
- run
cd signoz
to move to signoz directory - run
sudo make dev-setup
to configure local setup to run query-service - comment out frontend service section at
docker/clickhouse-setup/docker-compose.yaml
- comment out query-service section at
docker/clickhouse-setup/docker-compose.yaml
- add below configuration to clickhouse section at
docker/clickhouse-setup/docker-compose.yaml
expose:
- 9000
ports:
- 9001:9000
-
run
cd pkg/query-service/
to move to query-service directory -
Open ./constants/constants.go
- Replace
const RELATIONAL_DATASOURCE_PATH = "/var/lib/signoz/signoz.db"
withconst RELATIONAL_DATASOURCE_PATH = "./signoz.db".
- Replace
-
Install signoz locally without the frontend and query-service
- If you are using x86_64 processors (All Intel/AMD processors) run
sudo make run-x86
- If you are on arm64 processors (Apple M1 Macbooks) run
sudo make run-arm
- If you are using x86_64 processors (All Intel/AMD processors) run
ClickHouseUrl=tcp://localhost:9001 STORAGE=clickhouse go run main.go
Notes for Maintainers/Contributors who will change Line Numbers of Frontend & Query-Section. Please Update Line Numbers in
./scripts/commentLinesForSetup.sh
Query Service should now be available at http://localhost:8080
If you want to see how, frontend plays with query service, you can run frontend also in you local env with the baseURL changed to
http://localhost:8080
in filesrc/constants/env.ts
as the query-service is now running at port8080
Need to update https://github.com/SigNoz/charts.
- run
git clone https://github.com/SigNoz/charts.git
followed bycd charts
- it is recommended to use lightweight kubernetes (k8s) cluster for local development:
- create a k8s cluster and make sure
kubectl
points to the locally created k8s cluster - run
make dev-install
to install SigNoz chart withmy-release
release name inplatform
namespace. - run
kubectl -n platform port-forward svc/my-release-signoz-frontend 3301:3301
to make SigNoz UI available at localhost:3301
To install HotROD sample app:
curl -sL https://github.com/SigNoz/signoz/raw/main/sample-apps/hotrod/hotrod-install.sh \
| HELM_RELEASE=my-release SIGNOZ_NAMESPACE=platform bash
To load data with HotROD sample app:
kubectl -n sample-application run strzal --image=djbingham/curl \
--restart='OnFailure' -i --tty --rm --command -- curl -X POST -F \
'locust_count=6' -F 'hatch_rate=2' http://locust-master:8089/swarm
To stop the load generation:
kubectl -n sample-application run strzal --image=djbingham/curl \
--restart='OnFailure' -i --tty --rm --command -- curl \
http://locust-master:8089/stop
To delete HotROD sample app:
curl -sL https://github.com/SigNoz/signoz/raw/main/sample-apps/hotrod/hotrod-delete.sh \
| HOTROD_NAMESPACE=sample-application bash
Before making any significant changes, please open an issue. Each issue should describe the following:
- Requirement - what kind of use case are you trying to solve?
- Proposal - what do you suggest to solve the problem or improve the existing situation?
- Any open questions to address
Discussing your proposed changes ahead of time will make the contribution process smooth for everyone. Once the approach is agreed upon, make your changes and open a pull request(s). Unless your change is small, Please consider submitting different PRs:
- First PR should include the overall structure of the new component:
- Readme, configuration, interfaces or base classes etc...
- This PR is usually trivial to review, so the size limit does not apply to it.
- Second PR should include the concrete implementation of the component. If the size of this PR is larger than the recommended size consider splitting it in multiple PRs.
- If there are multiple sub-component then ideally each one should be implemented as a separate pull request.
- Last PR should include changes to any user facing documentation. And should include end to end tests if applicable. The component must be enabled only after sufficient testing, and there is enough confidence in the stability and quality of the component.
You can always reach out to [email protected]
to understand more about the repo and product. We are very responsive over email and slack.
- If you find any bugs, please create an issue
- If you find anything missing in documentation, you can create an issue with label documentation
- If you want to build any new feature, please create an issue with label
enhancement
- If you want to discuss something about the product, start a new discussion
- We try to follow https://www.conventionalcommits.org/en/v1.0.0/
More specifically the commits and PRs should have type specifiers prefixed in the name. This should give you a better idea.
e.g. If you are submitting a fix for an issue in frontend - PR name should be prefixed with fix(FE):
-
Follow GitHub Flow guidelines for your contribution flows
-
Feel free to ping us on
#contributing
or#contributing-frontend
on our slack community if you need any help on this :)