# Troubleshooting

# Troubleshooting

This page lists common failure modes and how to debug them systematically. When troubleshooting, start by identifying which layer is failing:

• ingestion (connector/integration)
• graph correctness (schemas, edges, keys)
• indexing (text/vector search)
• NLP/AI configuration (pipelines, embeddings, LLM provider)
• app logic (endpoints, UI, integrations)

# Ingestion: “My connector ran, but I don’t see data”

• Confirm the connector is writing to the correct workspace/environment.
• Validate schema existence (node types and edge types).
• Check that nodes are being committed (batch commit and final commit).
• Validate keys: if keys are empty or unstable, data may be deduplicated incorrectly or duplicated.

# Graph: “Relationships are missing”

• Ensure ingestion explicitly creates edges (relationships are not inferred).
• Validate edge type names and direction conventions.
• Run a neighbor summary query (or inspect a node’s neighborhood) to verify edge counts.

# Search: “Search returns no results”

• Confirm you have enabled indexing for the relevant node types and fields.
• Rebuild/reindex after enabling fields.
• If filtering is enabled, confirm facets aren’t excluding all results.

# Vector search: “Semantic results are bad”

• Confirm embedding indexing is enabled for the right fields.
• Enable chunking for long fields.
• Validate similarity cutoffs and evaluate using a small query set.
• Apply context constraints (facets/graph) to reduce noise.

# NLP: “Entities aren’t being captured”

• Confirm pipelines are configured for the correct language and field.
• Reparse/reprocess existing nodes after updating pipeline configuration.
• Run extraction experiments on representative samples and iterate on rules/models.

# Endpoints: “My endpoint works in the UI but fails externally”

• Confirm you are using the correct endpoint URL for external calls.
• Ensure the endpoint requires the correct authorization mode.
• Verify the endpoint token scope and expiration.
• Check logs for input validation failures.

# Next steps

• Learn the debugging primitives: Graph Query Language
• Improve observability: Administration → Monitoring