mirror of
https://github.com/labring/FastGPT.git
synced 2026-04-26 02:07:28 +08:00
Archer
87b0bca30c
* cloud doc * doc refactor * doc move * seo * remove doc * yml * doc * fix: tsconfig * fix: tsconfig
82 lines
3.3 KiB
Plaintext
82 lines
3.3 KiB
Plaintext
---
|
|
title: Integrate SigNoz Service Monitoring
|
|
description: FastGPT integration with SigNoz service monitoring
|
|
---
|
|
|
|
## Introduction
|
|
|
|
[SigNoz](https://signoz.io/) is an open-source Application Performance Monitoring (APM) and observability platform that provides comprehensive service monitoring for FastGPT. Built on the OpenTelemetry standard, it collects, processes, and visualizes telemetry data from distributed systems, including tracing, metrics, and logging.
|
|
|
|
**Key Features:**
|
|
|
|
- **Distributed Tracing**: Track the complete call chain of user requests across FastGPT services
|
|
- **Performance Monitoring**: Monitor key metrics like API response times and throughput
|
|
- **Error Tracking**: Automatically capture and record system exceptions for troubleshooting
|
|
- **Log Aggregation**: Centrally collect and manage application logs with structured query support
|
|
- **Real-time Alerts**: Set alert rules based on metric thresholds to detect anomalies early
|
|
|
|
## Deploy SigNoz
|
|
|
|
You can use [SigNoz](https://signoz.io/) cloud service or self-host it. Here's how to quickly deploy SigNoz on Sealos.
|
|
|
|
1. Click the card below to deploy SigNoz with one click.
|
|
|
|
[](https://hzh.sealos.run/?uid=fnWRt09fZP&openapp=system-template%3FtemplateName%3Dsignoz)
|
|
|
|
2. Enable external access for SigNoz
|
|
|
|
After deployment, click **Details** in P1 to open the app details page, then click **Change** in the top right and enable the external address for port 4318 (skip this step if using internal network).
|
|
|
|
| P1 | P2 | P3 |
|
|
| --- | --- | --- |
|
|
|  |  |  |
|
|
|
|
3. Get the SigNoz access address
|
|
|
|
After the change completes, wait for the public address to be ready, copy it, and enter it in FastGPT. If using internal network, copy the internal address for port 4318 directly.
|
|
|
|
|
|
|
|
## Configure FastGPT
|
|
|
|
1. Update FastGPT environment variables
|
|
|
|
**Log level options**: `trace` | `debug` | `info` | `warning` | `error` | `fatal`
|
|
|
|
```dotenv
|
|
LOG_ENABLE_CONSOLE=true # Enable console logging
|
|
LOG_CONSOLE_LEVEL=debug # Minimum log level for console output
|
|
LOG_ENABLE_OTEL=true # Enable OTEL log collection
|
|
LOG_OTEL_LEVEL=info # Minimum log level for OTEL collection
|
|
LOG_OTEL_SERVICE_NAME=fastgpt-client # Service name passed to the OTLP collector
|
|
LOG_OTEL_URL=http://localhost:4318/v1/logs # Your OTLP collector address — don't omit /v1/logs
|
|
```
|
|
|
|
2. Restart FastGPT
|
|
|
|
## Verify the Setup
|
|
|
|
Go back to the Sealos app management list, open the SigNoz frontend project, and access its public address to open the dashboard.
|
|
|
|
| | |
|
|
| --- | --- |
|
|
|  |  |
|
|
|
|
First-time access requires creating an account (data is stored in the local database) — fill in anything.
|
|
|
|
|
|
|
|
After logging in, if `logs` and `traces` are lit up in the COMPLETED steps on the right side, the configuration is successful.
|
|
|
|
|
|
|
|
|
|
|
|
## Notes
|
|
|
|
1. Adjust log retention period
|
|
|
|
SigNoz monitoring is very disk-intensive. First, avoid storing FastGPT debug logs in SigNoz. Also consider setting the log retention period to 7 days. If SigNoz data stops growing while memory keeps increasing, the disk is full — expand capacity.
|
|
|
|
|