Connecting Langfuse

The Greppilot Langfuse integration enables querying your LLM observability data directly from the dashboard. It provides capabilities to explore traces, generations, scores, sessions, daily metrics, and managed prompts.

Configuration

Langfuse requires both a Secret Key and a Public Key for connection.

  1. In the Greppilot dashboard, navigate to Integrations.
  2. Select the Langfuse integration.
  3. Provide your Secret Key and Public Key in the designated fields.

Generate API keys within your Langfuse project settings under API Keys.

Langfuse requires both a Secret Key (sk-lf-) and Public Key (pk-lf-). Both are found in your Langfuse project settings under API Keys.

ParameterTypeDescriptionRequired
secretKeystringLangfuse Secret Key (starts with sk-lf-).Yes
publicKeystringLangfuse Public Key (starts with pk-lf-).Yes
hoststringLangfuse host URL. Defaults to https://us.cloud.langfuse.com.No

Available Tools

Upon successful connection, the following Langfuse tools become available:

list_traces

List traces (request/interaction records).

ParameterTypeDescriptionRequired
namestringFilter by trace name.No
userIdstringFilter by user ID.No
sessionIdstringFilter by session ID.No
tagsarrayFilter by tags.No
fromTimestampstringISO start timestamp.No
toTimestampstringISO end timestamp.No
orderBystringOrder by: "timestamp", "latency", or "cost".No
limitnumberMax results. Default: 50, max: 100.No
pagenumberPage number. Default: 1.No

get_trace

Get a single trace by ID with all observations and scores.

ParameterTypeDescriptionRequired
traceIdstringThe trace ID to retrieve.Yes

list_generations

List LLM generation calls.

ParameterTypeDescriptionRequired
namestringFilter by generation name.No
modelstringFilter by model name.No
traceIdstringFilter by parent trace ID.No
fromStartTimestringISO start timestamp.No
toStartTimestringISO end timestamp.No
limitnumberDefault: 50, max: 100.No
pagenumberDefault: 1.No

list_scores

List quality scores and evaluations.

ParameterTypeDescriptionRequired
namestringFilter by score name.No
userIdstringFilter by user ID.No
traceIdstringFilter by trace ID.No
dataTypestring"NUMERIC", "BOOLEAN", or "CATEGORICAL".No
fromTimestampstringISO start timestamp.No
toTimestampstringISO end timestamp.No
limitnumberDefault: 50, max: 100.No
pagenumberDefault: 1.No

list_sessions

List sessions (groups of related traces).

ParameterTypeDescriptionRequired
fromTimestampstringISO start timestamp.No
toTimestampstringISO end timestamp.No
limitnumberDefault: 50, max: 100.No
pagenumberDefault: 1.No

get_daily_metrics

Get aggregated daily metrics including trace counts, observation counts, costs, and token usage.

ParameterTypeDescriptionRequired
traceNamestringFilter by trace name.No
userIdstringFilter by user ID.No
tagsarrayFilter by tags.No
fromTimestampstringISO start. Default: 7 days ago.No
toTimestampstringISO end. Default: now.No

list_prompts

List managed prompts in Langfuse.

ParameterTypeDescriptionRequired
namestringFilter by prompt name.No
labelstringFilter by label (e.g., "production").No
tagstringFilter by tag.No
limitnumberDefault: 50, max: 100.No
pagenumberDefault: 1.No

get_prompt

Get a specific prompt by name, optionally pinned to a version or label.

ParameterTypeDescriptionRequired
namestringPrompt name.Yes
versionnumberSpecific version number.No
labelstringLabel like "production" or "staging".No
Previous
Connecting PostHog
Next
MCP Servers