{Documentation} Aria Studio Logs & Troubleshooting page

Summary:
Adds Aria Studio Logs & Troubleshooting page to Project Aria Tools documentation.

Rendered by static docs below:
https://www.internalfb.com/intern/staticdocs/eph/D105329605/V2/projectaria_tools/ark/aria_studio/troubleshooting

Reviewed By: kongchen1992, spaceoddite

Differential Revision: D105329605

fbshipit-source-id: 4106f534ced9e89d9b78a3316bd967e5bffbaf37

Author: Piotr Brzyski

website/docs-ark/aria_studio/troubleshooting.mdx

@@ -3,6 +3,54 @@ sidebar_position: 80
 title: Logs & Troubleshooting
 ---
 
-:::note
-TBD: This page is under construction.
-:::
+## Application logs
+
+The **Logs** page provides a searchable, filterable view of Aria Studio's application logs for debugging and troubleshooting.
+
+![Logs page](/img/docs-ark/aria_studio/logs.png)
+
+### Log file location
+
+Aria Studio writes logs to `/tmp/logs/projectaria/log_YYYYMMDD_HHMMSS.log`.
+
+### Log columns
+
+Each log entry displays the following columns:
+
+| **Column** | **Description** |
+|--|--|
+| Time stamp | When the log entry was recorded |
+| Component | The system component that generated the log |
+| File | Source code file |
+| Line | Line number in the source file |
+| Level | Log level (DEBUG, INFO, WARNING, ERROR) |
+| Message | Log message content |
+| Status | HTTP status code (if applicable) |
+
+### Working with logs
+
+The **Component**, **File**, **Level**, **Message**, and **Status** column headers have a filter icon that lets you narrow log entries by that column's values.
+
+Use the actions menu (three-dot icon) on individual entries for additional options. These options include:
+- Copy message - Copies the raw log message to the clipboard.
+- File a bug - Opens the **Aria Studio Feedback & Support** dialog with the log message pre-populated.
+
+## Submit feedback
+
+Select **Feedback** in the sidebar to open the **Aria Studio Feedback & Support** dialog. Fill in:
+
+- **Report Type** — Select "Bug" for bug reports or other options for feature requests.
+- **Title** — A short summary (at least 8 characters). When reporting from a log entry, the title is pre-populated with an `[Aria Studio Log]` prefix, the entry's timestamp, and the log message.
+- **Details** — A detailed description to help the team understand your request. When reporting from a log entry, details are pre-populated with the log timestamp, component, file, and level.
+
+Select **Submit** to send the report.
+
+![Aria Studio Feedback & Support dialog](/img/docs-ark/aria_studio/bug_report.png)
+
+## Common issues
+
+For common issues and solutions, see [Aria Studio Troubleshooting](/ark/support/aria_studio).
+
+## Getting help
+
+If you can't resolve an issue, go to the [Support page](/ark/support) for how to contact our team.

website/docs-ark/support/aria_studio.mdx

@@ -21,9 +21,9 @@ This page provides troubleshooting support for issues relating to [Aria Studio](
 | **Issue** | **Resolution** |
 |--|--|
 | Gen 1 device not detected | Verify ADB is installed and on your PATH. Run `adb devices` in a terminal to confirm the device is visible. |
-| Gen 2 device not detected | Try unplugging and reconnecting. Ensure the device is powered on. |
+| Gen 2 device not detected | Try unplugging and reconnecting. Ensure the device is powered on. Use a USB data cable (not charge-only). |
 | Authentication fails | Open the Companion App and check for pending pairing requests. Make sure the glasses are powered on and unlocked. |
-| "Device mode is not supported" | The device may be in a mode that Aria Studio doesn't support. Check the device status in the Companion App. |
+| "Device mode is not supported" | The device may be in a mode that Aria Studio doesn't support. Check the device status in the Companion App. Ensure your device generation is supported on your operating system. |
 | Device appears but can't be selected | The device may not be authenticated. Select **Authenticate** in the Switch Glasses dialog to pair it. |
 | Multiple devices conflict | Only one device is active at a time. Switch between them using the Switch Glasses dialog. |
 
@@ -32,7 +32,6 @@ This page provides troubleshooting support for issues relating to [Aria Studio](
 | **Issue** | **Resolution** |
 |--|--|
 | "Device Not Connected" | Check that your USB cable is connected and the device is powered on. |
-| "Device mode is not supported" | Ensure your device generation is supported on your operating system. Gen 2 features require macOS or Linux. |
 | No recordings appear | Verify the glasses have recordings. Try disconnecting and reconnecting. |
 
 ## Live streaming
@@ -43,3 +42,26 @@ This page provides troubleshooting support for issues relating to [Aria Studio](
 | Viewer closes unexpectedly | Use the **Open Viewer** button to reopen without restarting the stream. |
 | Poor data quality | Try switching from Wi-Fi to USB for more reliable data transfer. |
 | "Prototype consent required" error | Accept the Prototype Mode consent dialog when prompted. |
+
+## MPS processing fails
+
+| **Issue** | **Resolution** |
+|--|--|
+| VRS file corrupted | Run the [VRS Health Check](/ark/vrs_health_check/installation) tool to validate your recording. |
+| Upload keeps failing | Try increasing the retry count and wait time in [Settings](/ark/aria_studio/settings). |
+| Server error | Check the [Past MPS Requests](/ark/aria_studio/mps) page for the error code and try again later. |
+
+## Visualization issues
+
+| **Issue** | **Resolution** |
+|--|--|
+| Rerun viewer doesn't open | Ensure [Rerun](https://rerun.io/) is installed (`pip install rerun-sdk`). |
+| Viewer shows stale data | Only one visualization runs at a time. Starting a new one replaces the previous. |
+
+## Application errors
+
+| **Issue** | **Resolution** |
+|--|--|
+| "Port already in use" | Another instance of Aria Studio may be running. Close it or use `--port` to specify a different port. |
+| App freezes during import | Large VRS files may take time. Check the import progress indicator. |
+| Settings not saving | Ensure all fields pass validation (no red error messages) before selecting Save. |