docs(integrations): Cognee tracing (TH-8328) by nik13 · Pull Request #1017 · future-agi/docs · GitHub
Skip to content

docs(integrations): Cognee tracing (TH-8328) - #1017

Draft
nik13 wants to merge 1 commit into
mainfrom
feat/th-8328-cognee-docs
Draft

nik13 wants to merge 1 commit into
mainfrom
feat/th-8328-cognee-docs

Conversation

@nik13

@nik13 nik13 commented Oct 17, 2026

Copy link
Copy Markdown
Contributor

Summary

New page src/pages/docs/integrations/traceai/cognee.mdx: how to send Cognee's own OpenTelemetry spans (add, cognify, search, LLM and embedding calls, graph and vector queries) to Future AGI. There is no traceAI-cognee package; the page is the docs side of the recipe in future-agi/traceAI#226 (python/examples/cognee): register() before the first Cognee call, the re-add line, and the export filter that keeps prompts, documents, answers and questions out by default.

Sections: install, environment variables, setup code, what is captured, privacy (default off, opt-in, stack traces never exported, what was checked), Cognee's own exporter as an alternative (content on; :443 rule; self-hosted gRPC needs lower-case header names), troubleshooting, limitations, and how it differs from traceAI instrumentors, EverOS and the Langfuse cookbook.

Nav suggestion (not edited here; the TH-8103 nav PR adds it): group traceAI / Integrations, next to EverOS, title Cognee.

Versions

  • cognee 1.6.5 (latest on PyPI, released 2026-10-16) and 1.6.2; fi-instrumentation-otel 1.1.0 (PyPI); OpenTelemetry SDK 1.45.1.
  • Live runs on Python 3.12; the recipe's tests on Python 3.10, 3.11 and 3.13 (cognee 1.6.5) and 3.11 (cognee 1.6.2), 75 passed each.

Evidence (2026-10-16, local Future AGI, real OpenAI gpt-4o-mini + text-embedding-3-small)

Run Trace Result
recipe, cognee 1.6.5, content off 7befb18a-2497-4590-b5c8-f9a2c5c5bb19 120 spans, 1 trace; llm 5, retriever 3, embedding 10; model openai/gpt-4o-mini; 0 errors
recipe, failing model, content off ce1159ea-c50f-4b15-8399-6aa7bbcc1e81 11 spans, 7 ERROR (LLM, pipeline tasks, memory.process, root); status litellm.exceptions.NotFoundError (detail removed: content capture off)
recipe, content capture on 17fb9d86-8dc8-4c93-9185-3b99962ced91 120 spans; LLM and search spans show Input/Output
recipe, cognee 1.6.2 c23c4360-9d41-4f8e-b781-41a8153ff34b, failure 30da4db6-39fc-4922-bc56-7650b3ab6f17 117 and 11 spans, same types
Cognee's exporter, gRPC to the local collector, lower-case headers 5 traces 119 spans stored
Cognee's exporter, https://api.futureagi.com:443/tracer/v1/traces (Future AGI cloud) n/a 2 trace POSTs answered 200; logs answered 404

fi_verify (content off project): traces=4 spans=262 ... PASS with --expect-type llm --expect-type retriever --expect-type embedding.

Privacy: with the defaults, a unique marker in the document and the question, the document text, the answer, local paths, the user name, the host name and all keys: 0 hits across every stored column (ClickHouse spans/traces/sessions, Postgres traces/spans/project) of 262 spans. With capture on, the marker is in the LLM and search spans' Input/Output; a capture-mode failing run sent 0 exception.stacktrace keys and 0 local paths on the wire (the previous filter sent 10 stack traces with 422 local-path occurrences).

Build: docs_build.sh BUILD_EXIT=0, audit-links: 0 broken nav links, 0 broken content links (the new page is one of the expected orphans until the nav PR).

Limitations

Alpha recipe. No tokens or cost (Cognee records none). Only search and LLM spans get a type. cognee.recall and agent-memory entry points are not mapped. Cognee Cloud and non-default backends not tested. Cognee's own exporter exports content (documented as such).

Linear: TH-8328 (parent TH-8103).

🤖 Generated with Claude Code

New page for sending Cognee's own OpenTelemetry spans to Future AGI with
the traceAI recipe (future-agi/traceAI#226): register() before the first
Cognee call, the re-add line, and the export filter that keeps content
out by default. Covers what is captured, the privacy default and opt-in,
Cognee's own exporter as an alternative (content on, :443 rule, gRPC for
self-hosted with lower-case headers), tested versions (cognee 1.6.5 and
1.6.2, verified 2026-10-16), troubleshooting, limitations and how it
differs from related integrations. No navigation change: the TH-8103 nav
PR adds the page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant