Investigating Integration Health
When something is failing, you usually have a question rather than a dashboard in mind: how many times did this fail, and why. NxAgent answers those questions in plain language against live platform data, so you get real figures rather than an estimate.
Ask it things like:
How many failures did Orders Service have yesterday?
Why is the SFTP job failing?
Show me the success rate for the invoice workflow over the last 7 days.
Before you begin
Use Ask mode. It is read-only: it can look things up and explain them but cannot change your application, which is what you want while investigating.
Ask a health question
- Open the workspace you want to investigate.
- Select the Generate icon in the top toolbar to open the chat panel.
- Select Ask from the mode selector.
- Enter your question.
Name the service, the time window, and the symptom. "Why did Orders Service fail yesterday afternoon" gives a sharper answer than "why is it broken".
What it can answer
| Capability | What you get |
|---|---|
| Health questions | Real figures pulled from live platform data |
| Name matching | Say "Orders Integration" or "Orders Service" and it finds the right one |
| Error investigation | Error types, how often they occur, and example failures |
| Performance metrics | Run counts, success rates, and record counts |
| How-to questions | Conceptual questions answered without running a data query |
Greetings get a friendly reply, and unrelated requests are declined.
Choose between asking and the dashboard
Two ways to check health, suited to different questions:
| Approach | Best for |
|---|---|
| Ask NxAgent | Investigating why something went wrong, with a specific answer |
| Metrics Dashboard | Monitoring and spotting trends, with a visual overview |
To open the dashboard, go to the Metrics Dashboard and select the Analytics tab. See Operating and Monitoring for the full dashboard reference.
Read the response
Triage answers can include an inline chart alongside the written analysis. Maximize the panel from the header for a larger view.
How you know it worked
You get named figures — counts, rates, and error types — rather than a general description. If NxAgent cannot match the service you named, it says so instead of guessing.
When it does not work
| Symptom | Cause | What to do |
|---|---|---|
| Figures do not match the environment you expected | The wrong environment is selected | Check the environment selector and resend |
| The answer is conceptual, not about your data | The question was a how-to, not a health question | Name the service and the time window |
Next steps
- Configuring Alerts — get told about failures instead of going to look.
- Operating and Monitoring — the full monitoring reference.