+++
title = "Управление диапазоном времени"
keywords = ["harvest", "dashboard", "documentation", "time range"]
aliases = ["/docs/harvest/latest/reference/timerange/"]
weight = 7
+++
# Элементы управления диапазоном времени

Harvest предоставляет несколько способов управления временными диапазонами визуализируемых данных как на уровне панели мониторинга, так и на уровне панели.

На этой странице описываются поддерживаемые единицы времени и относительные диапазоны, общие элементы управления временем, настройки времени для всей панели и настройки времени для конкретной панели.

## Единицы времени и относительные диапазоны

Поддерживаются следующие единицы времени: `s (секунды)`, `m (минуты)`, `h (часы)`, `d (дни)`, `w (недели)`, `M (месяцы)` и `г (лет)`.

Оператор минус позволяет сделать шаг назад во времени относительно настоящего. Если вы хотите отобразить полный период единицы измерения (день, неделя, месяц и т. д.), добавьте `/<единица времени>` в конец.

Оператор «плюс» позволяет вам сделать шаг вперед во времени относительно текущего момента. Вы можете использовать эту функцию, например, для просмотра прогнозируемых данных в будущем.

Вот некоторые примеры:

|Пример относительный диапазон| От:      | До:        |
| ---------------------- | ---------- | ---------- |
| Последние 5 минут     | `now-5m`   | `now`      |
  День до сих пор       | `now/d`    | `now`      |
| Эта неделя            | `now/w`    | `now/w`    |
|Эта неделя до сих пор   | `now/w`    | `now`      |
| Этот месяц             | `now/M`    | `now/M`    |
| Этот месяц до сих пор     | `now/M`    | `now`      |
| Предыдущий месяц        | `now-1M/M` | `now-1M/M` |
| Этот год до сих пор      | `now/Y`    | `now`      |
| Этот год            | `now/Y`    | `now/Y     |

## Общие элементы управления диапазоном времени

Приборная панель и элементы управления временем панели имеют общий пользовательский интерфейс (UI).

<img class="no-shadow" src="/static/img/docs/time-range-controls/common-time-controls-7-0.png" max-width="700px">

Опции определены ниже.

### Текущий диапазон времени

Текущий временной диапазон, также называемый _выбором времени_, показывает временной диапазон, отображаемый в данный момент на панели мониторинга или панели, которую вы просматриваете.

Наведите курсор на поле, чтобы увидеть точные метки времени в диапазоне и их источник (например, локальный браузер).

<img class="no-shadow" src="/static/img/docs/time-range-controls/time-picker-7-0.png" max-width="300px">

Нажмите на текущий временной диапазон, чтобы изменить временной диапазон. Вы можете изменить текущее время, используя _относительный диапазон времени_, например, последние 15 минут, или _абсолютный диапазон времени_, например, с `2020-05-14 00:00:00 до 2020-05-15 23:59:59` .

<img class="no-shadow" src="/static/img/docs/time-range-controls/change-current-time-range-7-0.png" max-width="900px">

### Относительный диапазон времени

Выберите относительный диапазон времени в списке **Относительные диапазоны времени**. Некоторые примеры временных диапазонов:

- Последние 30 минут
- Последние 12 часов
- Последние 7 дней
- Последние 2 года
- Вчера
- Позавчера
- В этот день на прошлой неделе
- Сегодня пока
- На этой неделе пока
- В этом месяце пока

### Абсолютный диапазон времени

Задайте диапазон абсолютного времени одним из двух способов:

- Введите значения в поля **От** и **Кому**. Вы можете ввести точные значения времени или относительные значения, например «сейчас-24 часа», а затем нажать **Применить диапазон времени**.
- Нажмите в поле **От** или **Кому**. Harvest отображает календарь. Выберите день или дни, которые вы хотите использовать в качестве текущего диапазона времени, а затем нажмите **Применить диапазон времени**.

В этом разделе также отображаются недавно использовавшиеся абсолютные диапазоны.

### Уменьшить масштаб (Cmd+Z или Ctrl+Z)

Щелкните значок **Уменьшить**, чтобы просмотреть увеличенный временной диапазон на информационной панели или панели визуализации.

### Увеличение (применимо только к графическим визуализациям)

Нажмите и перетащите, чтобы выбрать временной диапазон в визуализации, которую вы хотите просмотреть.

### Обновить панель инструментов

Щелкните значок **Обновить информационную панель**, чтобы немедленно выполнить каждый запрос на информационной панели и обновить визуализации. Harvest отменяет все ожидающие запросы при запуске нового обновления.

По умолчанию Harvest не обновляет панель инструментов автоматически. Запросы выполняются по собственному расписанию в соответствии с настройками панели. Однако если вы хотите регулярно обновлять панель мониторинга, нажмите стрелку вниз рядом со значком **Обновить панель мониторинга** и выберите интервал обновления.
## Настройки времени панели

Настройки времени сохраняются отдельно для каждой панели.

Чтобы получить доступ к настройкам времени панели управления, нажмите значок **Настройки панели управления** (шестеренка) в верхней части экрана. Настройки находятся в разделе **Параметры времени** на вкладке «Общие».

- **Часовой пояс -** Укажите местный часовой пояс отслеживаемой службы или системы. Это может быть полезно при мониторинге системы или службы, которые работают в нескольких часовых поясах.
  - **По умолчанию -** Используется выбранный по умолчанию часовой пояс для профиля пользователя, группы или организации. Если для профиля пользователя, команды, членом которой является пользователь, или организации не указан часовой пояс, то Harvest использует время локального браузера.
  - **Местное время браузера -** Используется часовой пояс, настроенный для браузера пользователя просмотра. Обычно это тот же часовой пояс, который установлен на компьютере.
  - Стандартные [часовые пояса ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), включая UTC.
- **Автообновление -** Настройте отображаемые параметры для относительного времени и параметры автоматического обновления. Записи разделяются запятыми и принимают любую допустимую единицу времени.
- **Задержка сейчас- -** Переопределите значение «сейчас», введя задержку по времени. Чаще всего эта функция используется для учета известных задержек при агрегировании данных, чтобы избежать нулевых значений.
- **Скрыть средство выбора времени -** Выберите этот параметр, если вы не хотите, чтобы Harvest отображала средство выбора времени.

## Переопределение времени панели и сдвиг времени

В [Параметры запроса]({{< relref "../panels/queries.md#query-options" >}}) вы можете переопределить относительный диапазон времени для отдельных панелей, чтобы они отличались от того, что выбрано в средство выбора времени на приборной панели в правом верхнем углу. Это позволяет одновременно отображать показатели за разные периоды времени или дни.

## Управляйте диапазоном времени с помощью URL

Временной диапазон информационной панели можно контролировать, указав следующие параметры запроса в URL-адресе информационной панели:

- `from` - определяет нижний предел диапазона времени, указанный в мс эпохе или [относительном времени]({{< relref "#relative-time-range" >}})
- `to` - определяет верхний предел диапазона времени, указанный в мс эпохе или [относительном времени]({{< relref "#relative-time-range" >}})
- `time` и `time.window` – определяет временной диапазон от `time-time.window/2` до `time+time.window/2`. Оба параметра должны быть указаны в мс. Например, `?time=1500000000000&time.window=10000` приведет к 10-секундному диапазону времени от 1499999995000 до 1500000005000.