Introduction
NxtOne is an AI-powered operational intelligence platform that captures software execution as semantic knowledge graphs, giving your team instant root cause analysis and deep system understanding.
What is NxtOne?
NxtOne works by attaching a lightweight agent to your application runtime. The agent captures method calls, data flows, service interactions, and database queries as they happen — then transforms them into a semantic ontology graph stored in Graph Database.
This graph becomes a queryable, AI-readable representation of how your system actually behaves. You can ask questions in natural language, trace execution flows visually, and get instant root cause analysis for any issue.
💡
NxtOne is not another monitoring tool. Unlike log aggregators or APM tools that show you metrics and traces, NxtOne captures execution semantics — the relationships and data flows that let AI reason about your system like a senior engineer would.
Key Features
- Semantic Knowledge Graph — your entire system architecture mapped from actual runtime behavior, not configuration files or outdated documentation.
- AI Root Cause Analysis — ask “why did this fail?” and get the exact service, method, and line of code responsible, across any number of microservices.
- Execution Time Machine — replay any request step-by-step, scrubbing through time to see exactly what happened at every point.
- Natural Language Queries — ask your system anything in plain English. Perfect for onboarding, debugging, and architecture reviews.
- Cross-Service Tracing — follow any request across every microservice with zero manual instrumentation.
- Live Event Streaming — watch execution events flow in real-time as they update the knowledge graph.
Quick Start
Get NxtOne running in your application in three steps:
1
Install the agent
Add the NxtOne agent to your project dependencies.
dependencies {
implementation 'me.nxtone:agent:1.0.0'
}
2
Annotate your application
Add the @NxtOneAgent annotation to your main application class.
@NxtOneAgent
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
3
Configure your API key
Set your NxtOne API key as an environment variable and deploy.
export NXTONE_API_KEY="nxt_live_k8s7d..."
export NXTONE_SERVICE_NAME="order-service"
# Deploy your application as normal
./gradlew bootRun
That's it. NxtOne will begin capturing execution data immediately. You'll see your first knowledge graph within minutes of your first request.
Configuration Reference
The NxtOne agent can be configured via environment variables or a nxtone.yml configuration file placed in your project root.
| Variable | Description | Default |
|---|
NXTONE_API_KEY | Your API key from the NxtOne dashboard | — |
NXTONE_SERVICE_NAME | Name of this service in the knowledge graph | Auto-detected |
NXTONE_ENDPOINT | NxtOne collector endpoint URL | https://collect.nxtone.ai |
NXTONE_SAMPLE_RATE | Percentage of requests to capture (0.0–1.0) | 1.0 |
NXTONE_MAX_DEPTH | Maximum call stack depth to capture | 50 |
NXTONE_EXCLUDE | Comma-separated list of packages to exclude | "" |
API Example
You can also interact with NxtOne programmatically via the REST API. Here's an example of creating an investigation:
# Start a new investigation
curl -X POST https://api.nxtone.ai/v1/investigations \
-H "Authorization: Bearer nxt_live_k8s7d..." \
-H "Content-Type: application/json" \
-d '{
"query": "Why are EU checkout orders failing?",
"service": "order-service",
"timeRange": "last_24h"
}'
📖
For the full API reference, including investigation endpoints, knowledge graph queries, and event streaming via WebSocket, see the
API Reference section.
Supported Stack
NxtOne currently supports the following languages, frameworks, and infrastructure:
Languages & Frameworks
| Language | Frameworks | Status |
|---|
| Java 17+ | Spring Boot, Micronaut, Quarkus | GA |
| Python 3.10+ | FastAPI, Django, Flask | GA |
| Node.js 18+ | NestJS, Express, Fastify | GA |
| Go 1.21+ | Gin, Echo, Fiber | COMING SOON |
Infrastructure
NxtOne integrates with Kafka, RabbitMQ, PostgreSQL, MySQL, MongoDB, Redis, Docker, Kubernetes, and AWS EKS out of the box. See the Integrations section for detailed setup guides.
Next Steps
- Follow the Quickstart Guide for a step-by-step walkthrough
- Learn about Core Concepts — ontologies, knowledge graphs, and how NxtOne reasons about your system
- Explore Debugging Workflows to see NxtOne in action for common debugging scenarios
- Set up CI/CD Integration to capture execution data from your test and staging environments