Логотип Performance HubPerformance Hub
Раздел сайта: Документация

Поиск запросов

На этой странице

На вкладке Logs перечислены запросы, выполненные в вашей организации, начиная с самых новых. С помощью фильтров в верхней части можно сузить список до одного человека, одного IP-адреса, одной части Performance Hub или одного типа результата, а затем щелкнуть запрос, чтобы просмотреть сведения о нем.

Краткая справка

Где найти: Настройки (значок шестеренки слева внизу) → Журналы аудита → Logs

Для кого: вам нужна роль, которая включает Журналы аудита и Identity & Access Management в вашей организации, например Organisation Administrator. См. раздел Кто может использовать Журналы аудита.

Назначение: поиск запросов, стоящих за вопросом, например кто что-то изменил или почему что-то не сработало

Вкладка Logs с панелью фильтров вверху, списком запросов слева и сведениями о выбранном запросе справаВкладка Logs с панелью фильтров вверху, списком запросов слева и сведениями о выбранном запросе справа

Рисунок 1. Вкладка Logs: фильтры вверху, подходящие запросы слева и выбранный запрос справа

Вкладка Logs

  • Панель фильтров: фильтры в верхней части, а справа — Live, кнопка обновления и Экспорт CSV.
  • Список: подходящие запросы, начиная с самых новых. Над ним указано "Viewing logs for 1 organisation" (или число организаций, которые вам видны). В каждой строке показаны код состояния, метод, значок источника, дата и время, конечная точка, адрес электронной почты пользователя и время ответа в миллисекундах.
  • Сведения: выбранный вами запрос. См. раздел Чтение записи журнала.

При прокрутке список подгружает новые запросы. В конце списка указано, сколько запросов найдено, например "End of results · 5 logs".

Фильтрация списка

  1. Щелкните фильтр на панели фильтров, например Endpoint.
  2. Выберите вариант или введите значение. Например, введите /api/door-gate-access/* в поле Endpoint и нажмите Apply.
  3. В фильтре отобразится выбранное значение, и список обновится. Чтобы сузить список еще больше, добавьте другие фильтры: запрос отображается, только если он соответствует всем фильтрам.
  4. Чтобы удалить один фильтр, щелкните на нем ×. Чтобы удалить все фильтры, нажмите Clear — эта кнопка появляется, когда задан хотя бы один фильтр.

Панель фильтров: Range, Email, IP, Endpoint, Org, Объект, Method и Status, затем Live, кнопка обновления и Export CSVПанель фильтров: Range, Email, IP, Endpoint, Org, Объект, Method и Status, затем Live, кнопка обновления и Export CSV

Рисунок 2. Панель фильтров: Range, Email, IP, Endpoint, Org, Объект, Method и Status, затем Live, кнопка обновления и Export CSV

ФильтрЧему соответствует
RangeВремя выполнения запроса. По умолчанию — Last 24 hours. См. раздел Range.
EmailПолный адрес электронной почты пользователя, например priya.shah@example.com. При вводе могут предлагаться адреса.
IPПолный IP-адрес, с которого поступил запрос, например 203.0.113.140
EndpointЧасть Performance Hub, к которой относился запрос. Совпадение ищется по любой части пути, можно использовать подстановочный знак *. См. раздел Конечная точка и подстановочные знаки.
OrgОдна организация или Any org. Отображается, если у вас есть доступ хотя бы к одной организации.
ОбъектОдин объект или Любой объект. Отображается, если у вас есть доступ хотя бы к одному объекту.
MethodGET, POST, PUT, PATCH или DELETE
StatusСтатус ответа. См. раздел Статус.

Для Email и IP нужно полное значение

Фильтры Email и IP находят только точные совпадения. Введите полный адрес электронной почты, например ruby.castellano@example.com, или полный IP-адрес. По части адреса, например ruby или 203.0.113, ничего не найдется.

Чтобы найти человека, не зная его полного адреса, воспользуйтесь списком Top Users на панели инструментов или откройте один из его запросов и скопируйте адрес из поля User.

Диапазон

Щелкните Range, чтобы выбрать, за какой период просматривать запросы.

  • Готовые варианты: Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days и Last 90 days.
  • Даты: выберите начальную и конечную даты в календаре на два месяца, затем нажмите Apply. Нажмите Cancel, чтобы закрыть меню, не меняя период. Даты старше 90 дней выбрать нельзя.

Примечание в нижней части меню сообщает, как долго хранятся журналы: "Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply)."

Открытое меню Range с готовыми вариантами от Last 15 minutes до Last 90 days, календарем на два месяца и примечанием о сроке хранения журналовОткрытое меню Range с готовыми вариантами от Last 15 minutes до Last 90 days, календарем на два месяца и примечанием о сроке хранения журналов

Рисунок 3. Range: выберите готовый вариант или даты в календаре. Примечание показывает, как долго хранятся журналы

Конечная точка и подстановочные знаки

Конечная точка — это путь, по которому был отправлен запрос, например /api/door-gate-access/doors/front-entrance/unlock. По ней видно, к какой части Performance Hub относился запрос.

  • Без * совпадение ищется по любой части пути. Например, unlock находит все запросы, в пути которых есть "unlock".
  • С * в пути должны присутствовать все фрагменты между звездочками. Например, /api/door-gate-access/* находит все запросы Door & Gate Access, а /partner/v1/* — все запросы от интеграций, использующих Partner API.

Открытый фильтр Endpoint с введенным значением /api/door-gate-access/* и кнопками Cancel и ApplyОткрытый фильтр Endpoint с введенным значением /api/door-gate-access/* и кнопками Cancel и Apply

Рисунок 4. Фильтр Endpoint поддерживает подстановочный знак *, например для поиска всех запросов к дверям

Вкладка Logs, отфильтрованная по /api/door-gate-access/*, с пятью запросами к дверям, первый из которых открытВкладка Logs, отфильтрованная по /api/door-gate-access/*, с пятью запросами к дверям, первый из которых открыт

Рисунок 5. Список после фильтрации по шаблону конечной точки

Не знаете, какую конечную точку указать? Откройте известный вам запрос, например разблокировку двери, которую вы выполнили сами, и скопируйте начало его конечной точки из сведений.

Статус

Щелкните Status, чтобы отфильтровать список по статусу ответа. Чтобы быстро найти статус, введите его в поле Search…, например "403". Выберите Any, чтобы показать все статусы.

Статусы перечислены с названиями, например 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error и 503 Service Unavailable. Их значение описано в разделе Коды состояния.

Открытое меню Status с полем поиска, вариантом Any и статусами от 200 OK до 401 UnauthorisedОткрытое меню Status с полем поиска, вариантом Any и статусами от 200 OK до 401 Unauthorised

Рисунок 6. Фильтрация по статусу ответа

Live и обновление

На вкладке Logs режим Live по умолчанию находится в положении Off, поэтому список не меняется, пока вы проводите расследование. Включите его и выберите частоту обновления списка, чтобы следить за поступлением новых запросов. Нажмите кнопку обновления (круговые стрелки), чтобы перезагрузить список один раз.

Отправка отфильтрованного представления или добавление его в закладки

Ваши фильтры сохраняются в адресе страницы. Добавьте страницу в закладки, чтобы вернуться к тому же представлению, или отправьте адрес коллеге. Коллега увидит тот же отфильтрованный список, если у него есть доступ к разделу Журналы аудита и к той же организации.

Например, адрес, заканчивающийся на /audit-logs/logs?email=priya.shah%40example.com, открывает список, отфильтрованный по этому человеку, а адрес, заканчивающийся на /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F*, — все запросы к дверям.

Перемещение по списку

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

Нет результатов

Если ничего не найдено, в списке отображается "No logs match these filters" и "Try widening the time range or clearing a filter."

Вкладка Logs с заданным фильтром Email и сообщением No logs match these filtersВкладка Logs с заданным фильтром Email и сообщением No logs match these filters

Рисунок 7. Подходящих запросов нет: расширьте период или удалите фильтр

Чтобы найти то, что вы ищете:

  • Выберите более длинный период в Range, например Last 7 days.
  • Убедитесь, что в полях Email и IP указан полный адрес. По части адреса ничего не найдется.
  • Удаляйте фильтры по одному с помощью × или нажмите Clear.