Documentation
Docs/Getting Started/Introduction

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 observes method calls, data flows, service interactions, and database queries as they happen — translating live execution into a secure, contextual map of system behavior.

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:

1

Install the agent

Add the NxtOne agent to your project dependencies.

xml
<dependency> <groupId>io.nxtone</groupId> <artifactId>nxtone-spring-boot-starter</artifactId> <version>0.1.0</version> </dependency>
2

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); } }
3

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 mvn spring-boot:run

That's it. NxtOne will begin capturing software behavior immediately. You'll see insights within seconds 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.

VariableDescriptionDefault
NXTONE_API_KEYYour API key from the NxtOne dashboard
NXTONE_SERVICE_NAMEName of this serviceAuto-detected
NXTONE_EXCLUDEExclude specific application packages from analysis""

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

LanguageFrameworksStatus
Java 17+Spring Boot, Micronaut, QuarkusGA
Python 3.10+FastAPI, Django, FlaskGA
Node.js 18+NestJS, Express, FastifyGA
Go 1.21+Gin, Echo, FiberCOMING SOON

Next Steps

On This Page
What is NxtOne?Key FeaturesQuick StartInstall the agentAnnotate your applicationConfigure API keyConfiguration ReferenceAPI ExampleSupported StackLanguages & FrameworksNext Steps