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

# Memfault

> Connect Memfault for device crash analytics, firmware monitoring, and fleet health

## Overview

Integrate Memfault with Telemetron to give your AI support agent access to device crash analytics, firmware version tracking, and fleet health metrics. When connected, the agent can look up device status, recent crashes, and diagnostic reports directly during support conversations.

## Prerequisites

* A Memfault account with an active project
* An Organization Access Token with read permissions
* At least one device registered in your Memfault project for testing

## Setup

<Steps>
  <Step title="Open the Integration Page">
    Go to **Settings > Integrations > Memfault**.
  </Step>

  <Step title="Enter Organization Access Token">
    Generate or retrieve your token from Memfault:

    1. In Memfault, navigate to **Admin > Organization Auth Token**
    2. Click **Create Token**
    3. Copy the generated token and paste it into Telemetron
  </Step>

  <Step title="Enter Organization Slug">
    Find your organization slug in the Memfault URL. It appears after `/organizations/` in the URL:

    ```
    https://app.memfault.com/organizations/{ORGANIZATION_SLUG}/projects/...
    ```
  </Step>

  <Step title="Enter Project Slug">
    Find your project slug in the Memfault URL. It appears after `/projects/` in the URL:

    ```
    https://app.memfault.com/organizations/.../projects/{PROJECT_SLUG}/...
    ```
  </Step>

  <Step title="Enter Test Device Serial ID">
    Provide a device serial number for connection testing:

    1. In Memfault, go to **Fleet > Devices**
    2. Copy the serial number of any device exactly as displayed
    3. Paste it into the **Test Device Serial ID** field
  </Step>

  <Step title="Connect">
    Click **Connect Memfault** to finalize the integration. Telemetron will verify access using the test device.
  </Step>
</Steps>

## Configuration

Once connected, the integration page shows:

| Field                 | Value                           |
| --------------------- | ------------------------------- |
| **Organization Slug** | Your Memfault organization slug |
| **Project Slug**      | Your Memfault project slug      |

### Direct API Access

Toggle **Enable Direct API Access** to allow the AI agent to query Memfault directly during conversations. When enabled, the agent can:

* Look up device information by serial number
* Retrieve crash reports and coredumps
* Query device traces and diagnostic data
* Check firmware versions and update status

<Warning>
  Data points must be marked as **attributes** in Memfault for Telemetron to receive them. Metrics that are not configured as attributes will not be available to the AI agent.
</Warning>

## How It Works

Telemetron connects to the Memfault API using your Organization Access Token. The AI support agent can query device health data, crash analytics, and firmware information in real time. When a customer reports an issue, the agent can automatically look up the device's recent crash reports, firmware version, and fleet-wide patterns to help diagnose problems faster.

## Troubleshooting

| Issue                                          | Resolution                                                                                                                 |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Authentication failed**                      | Verify the Organization Access Token is correct and has not been revoked. Generate a new token if needed.                  |
| **Organization or project not found**          | Double-check the organization and project slugs. Copy them directly from the Memfault URL to avoid typos.                  |
| **Test device not found**                      | Ensure the serial number matches exactly, including case. The device must exist in the specified project.                  |
| **Missing telemetry data**                     | Confirm that the data points you expect are marked as **attributes** in Memfault. Non-attribute metrics are not forwarded. |
| **Direct API queries returning empty results** | Verify that **Enable Direct API Access** is toggled on. Check that the device has recent data in Memfault.                 |