Application List¶
In the Application List, you can view information about applications created under various integrated application frameworks.
Concepts¶
| Term | Description |
|---|---|
| Call Count | Counts the number of trace requests for the application |
| Error Rate | The percentage of failed requests for the application Calculation formula: Error Rate = (Number of error traces / Total number of traces) * 100% (❗️A trace is considered erroneous if any span within it fails) Different colors represent different error rate ranges: |
| Total Tokens | The total token usage (total_tokens) for a single requestFormat: Total Tokens (Input Tokens → Output Tokens) |
| P50/P75 Duration | Statistics for the application's P50/P75 request time (duration) |
Create Application¶
Go to the Create Application page, which currently supports Integrating Langfuse by default:
-
Define the application name and application ID;
-
System automatically generates configuration parameters;
-
A Client Token is generated by default, which you can replace as needed;
-
Select the integration configuration;
-
Click "Create".
What is a Client Token?
After creating an application, the system automatically generates a Client Token for you. This token is used to send data from user devices.
For more details, refer to Client Token Management.
After successful creation, you can go to the "Application List" page to view it.
Integration Configuration¶
Generally supports three types here:
Integrate Other Models/Frameworks
Integrate Python¶
1. Install dependencies:
2. Initialize the client:
3. Verify connection:
You can use langfuse.auth_check() to verify if the integration was successful. It is not recommended to use this in production as it increases application latency.
from langfuse import Langfuse
# Initialize (via parameter construction)
langfuse = Langfuse(
public_key="app_id",
secret_key="llm_bb0f30d.....66eec",
host="https://llm-openway.guance.com"
)
# Verify connection, this is a synchronous call, not recommended for production, this method is only for verifying configuration
if langfuse.auth_check():
print("Langfuse client is authenticated and ready!")
If the integration fails, you might encounter the following error:
langfuse.api.resources.commons.errors.unauthorized_error.UnauthorizedError: status_code: 401, body: {}
This error usually indicates that the App ID or Client Token is incorrect, please check your parameter configuration.
For more details and end-to-end examples, refer to Python.
Integrate JS/TS¶
Note
This configuration is only applicable to Langfuse JS/TS SDK v4, v3 is not currently supported.
1. Install dependencies:
Click to view more package information.
2. Register Credentials
Set the following environment variables in your application environment. Ensure you have a .env file in your project root directory and a package like dotenv to load the variables.
LANGFUSE_SECRET_KEY="llm_122f6b85d0c7454fa0f9*****d360"
LANGFUSE_PUBLIC_KEY="pk-lf-..."
LANGFUSE_BASE_URL="http://testing-openway.dataflux.cn",
3. Initialize OpenTelemetry
Langfuse SDK tracing is built on OpenTelemetry, so you need to set up the OpenTelemetry SDK. The LangfuseSpanProcessor is the key component for sending traces to Langfuse.
import { NodeSDK } from "@opentelemetry/sdk-node";
import { LangfuseSpanProcessor } from "@langfuse/otel";
const sdk = new NodeSDK({
spanProcessors: [new LangfuseSpanProcessor()],
});
sdk.start();
Click to view the Ollama Integration Example.
For more details and end-to-end examples, refer to JS/TS.
Integrate Others¶
If you need to integrate other models/frameworks, such as DeepSeek, Ollama, LangChain, Dify, etc., refer to the Langfuse Official Complete Documentation for configuration.
Application List¶
In the Application List, you can view information such as the application name, call count, error rate, total tokens, P50/P75 duration, etc.
You can manage the list through the following operations:
-
Search and locate by application name;
-
Filter by selecting a time range using the Time Widget;
-
Edit/Delete applications;
-
Click on a single application to directly jump to the Explorer page with that application as the query condition.