Introduction

NxtOne is an AI-powered operational intelligence platform that captures software behaviour to give 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 records them as structured behaviors and actions in a database.

This 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 runtime behaviors, actions, and data flows that let AI reason about your system like a senior engineer would.

Key Features

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.
Distributed Investigation — follow any request across every microservice with zero manual instrumentation.
Live Event Streaming — watch execution events flow in real-time as they update your system view.

Quick Start

Get NxtOne running in your application in three steps:

Install the agent

Add the NxtOne agent to your project dependencies.

build.gradle

dependencies {
    implementation 'me.nxtone:agent:1.0.0'
}

Annotate your application

Add the @NxtOneAgent annotation to your main application class.

Application.java

@NxtOneAgent
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

Configure your API key

Set your NxtOne API key as an environment variable and deploy.

bash

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 software behavior immediately. You'll see insights 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	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:

bash

# 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 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 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 software behavior from your test and staging environments

Quickstart Guide

On This Page

What is NxtOne?Key Features Quick Start Install the agent Annotate your application Configure API key Configuration Reference API Example Supported Stack Languages & Frameworks Infrastructure Next Steps