# Search and filter

Find who did what and when in the logs, with text search, filters by log, script and player, a time period and each log's details.

Source: https://fivedash.fivex.gg/docs/en/logs/search-and-filter

When someone asks "who took the rifle out of the faction's chest yesterday?", the answer is in the logs. The FiveDash explorer puts all of the city's logs in one list, with search, filters and each log's details. This page is for the staff who investigate what happened on the server.

[Video: how to do it in under 20 seconds](https://fivedash.fivex.gg/docs/videos/logs-search-en.mp4)

## Before you start

* **Access level:** **View** on **All logs**, or **View** on each log you need. You only see the logs you've been given.
* **Logs on:** the logs setup must be finished. See [Create logs](https://fivedash.fivex.gg/docs/en/logs/create-logs).

## Where to search

| Page         | Path                      | What it lists                                     |
| ------------ | ------------------------- | ------------------------------------------------- |
| **All logs** | **Logs → All logs**       | Everything the city's scripts send, in one place. |
| One log      | **Logs →** the log's name | Only that log's entries.                          |

## Search for a log

### Open the explorer

Go to **Logs → All logs** (or open a log in the sidebar).

### Type your search

In the **Search the logs: name, item, plate, command…** box, type what you're looking for. Search looks at the title, the values and the script's name, ignoring case.

### Pick the period

Click the period and pick an option. For an exact window, pick **Custom (Brasília time)**, fill in **From** and **To** and click **Apply**.

### Open the log

Click a log in the list to see its details.

## Periods

| Option                     | What it covers                                                                                                  |
| -------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Last hour**              | The last 60 minutes.                                                                                            |
| **Last 24 hours**          | The last day.                                                                                                   |
| **Last 7 days**            | The last week. This is the default.                                                                             |
| **Last 30 days**           | The last month.                                                                                                 |
| **All time**               | Everything that's still kept.                                                                                   |
| **Custom (Brasília time)** | From one date and time to another. An empty **From** means "From the start"; an empty **To** means "Until now". |

## Filters

Click **Filters** to open the filters. Each filter takes up to 20 values, and a log shows if it matches any of them. **Clear filters** removes them all.

| Filter     | What it does                                                                                                                                                        | Default        |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| **Log**    | Shows only the chosen logs (only in **All logs**).                                                                                                                  | All            |
| **Script** | Shows only what one script sent (the webhook name, its `username`). Search in **Search scripts**.                                                                   | All            |
| **Player** | Shows logs that mention a player. Type in **Player ID, Discord or license** and press Enter; you can add several. **Seen in the latest logs** lists recent players. | None           |
| **Tests**  | **Show tests** (alongside the scripts' logs), **Hide tests** (only what the scripts sent) or **Tests only** (the ones sent from the panel).                         | **Show tests** |

### How the Player filter reads the value

| You type                                           | FiveDash looks for                                                                                |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| A 17 to 20 digit number, like `312456789012345678` | The **Discord account**: every log that mentions it. A mention `<@312456789012345678>` works too. |
| Something with `:`, like `license:4f1c…`           | The **identifier**: license, steam, fivem…                                                        |
| Any other value, like `1042`                       | The **character ID (passaporte)**.                                                                |

> In the list or the details, click a player's ID (**Show only ID …'s logs** / **Filter**) to filter by them right away.

## The list

| Part               | What it shows                                                                                                                                 |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Period summary** | How many logs, the hourly average, the **Players** (characters in the logs), the **Peak** and the **Latest log**, with a chart of the period. |
| List               | Logs from newest to oldest, grouped by **Today**, **Yesterday** and date.                                                                     |
| **Per page**       | 25, 50 (default) or 100 logs per page, with **First**, **Previous** and **Next**.                                                             |
| **Showing … of …** | The total. Counting stops at 10,000 (it shows "10,000+").                                                                                     |

### Live and paused

The explorer opens **Live**: new logs come in on their own. Click **Live** to pause (new logs wait until you come back) and **Paused** to go live again. When the list changes a lot, use **Refresh history**.

## A log's details

Click a log to open its details beside the list. Use the ↑ and ↓ keys to go to the **Previous log** and the **Next log**.

| Section           | What it shows                                                                                                                                                                     |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Who**           | The log's players: **Character ID**, name and Discord account (picture and name, read with the server's bot).                                                                     |
| **What happened** | The title, the text and the **Details**: each value read from the log, with a copy button.                                                                                        |
| **Where**         | The **Coordinates** found in the log (**Location 1**, **Location 2**…).                                                                                                           |
| **Source**        | **Log**, **Arrived through** (**FiveDash export** or **Webhook**), **Resource**, **Script**, **Received**, **Time in the city**, **Time in the embed**, **Files** and **Log ID**. |

## Share a search

The search, filters, period and page live in the page's address. Copy the address from the browser and send it to someone else on the staff: they open the same search. An open log is in the address too, and the link opens its details directly. The other person only sees what their access allows.

## FAQ

**I searched for a player and got nothing. Why?**
The **Player** filter only finds logs where the character ID, Discord account or identifier shows up in the text. Check that the script sends it and that the period covers the date. Also try a text search.

**I got "This query expired or your access to the logs changed."**
Click **Go to the first page** to run the search again.

**Why don't I see a log in the filter list?**
You only see the logs you've been given. Ask an owner or admin of the organization in **Settings → Members**.

## Next steps

[Logs assistant](https://fivedash.fivex.gg/docs/en/logs/assistant)Let the AI investigate for you.
[Logs overview](https://fivedash.fivex.gg/docs/en/logs/overview)The server's numbers and charts.
[Replace Discord webhooks](https://fivedash.fivex.gg/docs/en/logs/migrate-from-webhooks)What FiveDash reads from each log.
[Team and permissions](https://fivedash.fivex.gg/docs/en/dashboard/team-and-permissions)Give the staff access to logs.
