> ## Documentation Index
> Fetch the complete documentation index at: https://agent-observability-docs.splunk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common errors and how to recover.

This page covers the most common errors users hit and what to do about them. If you're stuck on something not listed here, reach out via the [Splunk Agent Observability support channels](/references/faqs/faqs).

## Account

### Can't sign in

You see **Invalid email or password** on the sign-in page.

| Likely cause          | What to try                                                      |
| --------------------- | ---------------------------------------------------------------- |
| Wrong password        | Click **Forgot your password?** on the sign-in page to reset it. |
| Account doesn't exist | Click **Create account** to create an account.                   |
| Typo in the email     | Re-check the email — case matters in some setups.                |

If you reset your password but still can't sign in, the reset email may not have arrived. Check spam, and confirm the email matches your Luna Studio account.

## Integrations

### Save changes button is disabled

The modal won't let you submit.

| Likely cause                              | Fix                                                                            |
| ----------------------------------------- | ------------------------------------------------------------------------------ |
| A required field is empty                 | Fill in every field marked required.                                           |
| JSON in a code-editor field doesn't parse | The editor highlights the offending line. Common: trailing comma, smart quote. |
| Disclaimer switch isn't toggled on        | Some providers gate save behind the "I acknowledge..." switch.                 |

### Provider returns 401 / unauthorized

Validation passes when adding the integration but runs fail with provider auth errors.

| Likely cause              | Fix                                                                                                                    |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Stale or invalid API key  | [Update](/luna-studio/ui/integrations/llm-providers#update-or-remove-an-integration) the integration with a fresh key. |
| Key lacks provider access | Confirm the provider account can use the selected model.                                                               |
| Insufficient quota        | Check your provider's quota dashboard. Quota failures commonly return 429 rather than 401.                             |

## Datasets

### Validation error: "Missing column"

You see a missing-column error after selecting a dataset for a run.

| Likely cause                         | Fix                                                                                                                                      |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| A required feature column is absent  | Check the [shape-specific schema](/luna-studio/ui/prerequisites#required-dataset-format), add the exact required columns, and re-upload. |
| `label` is absent from a test set    | Add an integer label column and re-upload. Boolean evaluators require `0` and `1`, not `true` and `false`.                               |
| `label` is absent from training logs | In Step 3, choose **Label with evaluator prompt instead**, configure the labelling model, and explicitly start the labelling pass.       |

### JSONL imports but fails when used in a run

The source picker accepts `.jsonl` during ingestion, but current run validation and data generation read the stored file as CSV. Convert the JSONL records to a CSV with the columns required by the selected evaluator shape, then upload the CSV as a new dataset.

### Validation error: "Could not fetch URL"

Luna couldn't pull the file from the URL you gave it.

| Likely cause                 | Fix                                                                                                   |
| ---------------------------- | ----------------------------------------------------------------------------------------------------- |
| URL requires authentication  | Create a pre-signed HTTPS URL. Luna Studio does not send custom request headers or cloud credentials. |
| Raw `s3://` or `gs://` URI   | Replace it with a publicly reachable or pre-signed HTTPS URL.                                         |
| Private or internal host     | Host the file at a public HTTP(S) endpoint; Luna Studio blocks private-network targets.               |
| URL returns a non-200 status | Open the URL to confirm it still serves the file; regenerate it if a signed link expired.             |

### Generated dataset doesn't look right

You ran **Generate from test set** and the samples are repetitive, off-topic, or mislabelled.

| Likely cause                         | Fix                                                                              |
| ------------------------------------ | -------------------------------------------------------------------------------- |
| Test set seeds aren't representative | Add more diverse rows to the test set, then regenerate.                          |
| Generation model too small           | Switch to a larger available model from one of your configured providers.        |
| Evaluator prompt is ambiguous        | Clarify the prompt; click **Regenerate** with the "Provide own feedback" reason. |

### Register evaluator fails with duplicate name

The Splunk Agent Observability evaluators store already has an evaluator with that name.

* Pick a different name in the [Register evaluator modal](/luna-studio/ui/runs/register-evaluator).
* Or, delete the existing evaluator in the [Splunk Agent Observability evaluators store](/concepts/evaluators/overview) first, then register again.

### Stuck in **Queued**

If a run sits in **Queued** for more than a few minutes, the most likely causes are:

* **Heavy load.** Luna provisions training capacity per region. Wait a few more minutes.
* **Integration removed.** If the integration backing the evaluator template was removed after launch, the run can't allocate. Re-add the integration and launch a new run.

If neither applies, contact Splunk Agent Observability support.

## Where to go next

<CardGroup cols={2}>
  <Card title="FAQ" icon="circle-question" href="/luna-studio/ui/reference/faq">
    Common questions about how Luna Studio works.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/luna-studio/ui/quickstart">
    End-to-end walkthrough.
  </Card>
</CardGroup>
