SigNoz is an open-source, OpenTelemetry-native observability platform for your team and their AI agents. Get logs, metrics, and traces in one tool with features like APM, distributed tracing, log management, infra monitoring, etc. Combined with SigNoz MCP and a native AI teammate (in SigNoz Cloud) it helps you build more resilient apps.
SigNoz Frontend
React-based web interface for SigNoz, the open-source observability platform.
Tech Stack
- Framework: React 18 + TypeScript
- Build: Vite
- State: React Query, Zustand, Redux Toolkit (legacy)
- Styling: CSS Modules, Ant Design (legacy)
- Charts: uPlot
- Testing: Jest
Local Development Setup
Run SigNoz backend locally — see Self-Host Docs
Configure environment:
cp example.env .envKey variables in
.env:# Backend API endpoint (required) VITE_FRONTEND_API_ENDPOINT="http://localhost:8080" # Enable bundle analyzer (optional) BUNDLE_ANALYSER="true"Install and run:
pnpm install pnpm dev
Development
pnpm dev
Opens http://localhost:3301.
Build
pnpm build
Output in build/ folder.
Bundle Size Analysis
Set in .env:
BUNDLE_ANALYSER="true"
Then run build:
pnpm build
Opens bundle analyzer visualization automatically.
Testing
# Unit tests
pnpm test
# Type checking
pnpm tsgo --noEmit
Storybook
pnpm storybook
Opens http://localhost:6006. Pages run against msw
mocks with no backend; query-param navigation works inside a story, leaving the
page is blocked. See src/storybook/README.md for the
override surface.
Linting
# Run all linters (oxlint + stylelint)
pnpm lint
Project Structure
src/
├── api/ # API clients and react-query hooks
├── components/ # Shared UI components
├── container/ # Page-level containers
├── hooks/ # Custom React hooks
├── pages/ # Route pages
├── providers/ # React context providers
├── store/ # Redux store
└── types/ # TypeScript definitions
Contributing
See CONTRIBUTING.md in the root repo.
Questions? Join our Slack community.