Термин «запрос метрики в архиве» является многозначным и в зависимости от контекста относится к двум совершенно разным областям: генеалогии/истории (поиск метрических книг ЗАГС/церкви в государственных архивах) и веб-аналитике (выгрузка данных через API Яндекс.Метрики или работа с архивированными отчетами). В данной статье подробно разобраны оба аспекта на основе актуальной информации и практики.

Часть 1. Генеалогический и исторический контекст: Метрические книги в государственных архивах

В российской архивоведении «метрика», это общепринятое сокращение от метрических книг (активов гражданского состояния: рождения, браков, смертей), которые до 1917 года вела церковь, а после — органы ЗАГС. По истечении сроков хранения (обычно 75–100 лет) они передаются в государственные архивы.

Подготовительный этап: Что нужно знать перед запросом

Прежде чем писать в архив, необходимо собрать минимальный пакет исходных данных. Без них поиск невозможен или займет месяцы.

• ФИО искомого человека (как можно полнее).
• Примерный год события (рождения, брака, смерти). Ошибка в ±2–5 лет существенно усложняет поиск.
• Место события (губерния, уезд, волость, деревня/село/город). Важно: название населенного пункта могло меняться.
• Конфессия (православные, католики, лютеранские, евреи, мусульмане — книги хранились раздельно).

Важно: Определите, в каком архиве сейчас находятся фонды. Это может быть:

• Областной/краевой/республиканский государственный архив (ГАО, ГАКО и т.д.).
• Центральный государственный архив Москвы (ЦГА Москвы) или Санкт-Петербурга.
• РГАДА (Российский государственный архив древних актов) — для очень старых фондов (XVII–XVIII вв.).
• Исторические архивы (например, в Казани, Нижнем Новгороде и др.).

Как составить грамотный письменный запрос

Архивы принимают запросы по почте, через формы на сайтах (например, «Написать в архив» на портале archives.gov.ru) или через Госуслуги. Телефонные справки обычно не даются.

Поиск в информационных системах архивов (на примере ЦГА Москвы)

Многие крупные архивы (ЦГА Москвы, архивы Московской, Псковской, Нижегородской областей и др.) имеют онлайн-каталоги с продвинутым поиском. Это позволяет найти номер фонда, описи и дела до отправки официального запроса.

Возможности расширенного поиска (ЦГА Москвы и аналоги):

• Поиск по ключевым словам (название села, церкви).
• Поиск по номерам: Фонд / Опись / Дело.
• Фильтр по годам или периоду (например, 1850–1860).
• Фильтр «Только с сканами онлайн», критически важно для удаленной работы.
• Использование минус-слов для отсева лишних находок.
• Поиск по названию фонда или описи.

Пример находки: «Список метрик фонда 3 описи 15 полностью оцифрован и выложен на сайте архива / Яндекс.Диск (есть географический указатель по сёлам)». Всегда проверяйте, оцифровано ли дело — это сэкономит недели ожидания.

Особенности доступа к документам

• Сроки хранения: Справки из книг младше 100 лет выдаются только родственникам (прямая восходящая линия) по предъявлении паспорта и документов, подтверждающих родство.
• Формат выдачи: Архивная справка (подпись заведующего, печать), скан страницы книги (платная услуга), заверенная копия.
• Исторический контекст: Помните, что до 1765 года Литовская метрика хранилась в Вильно, а ранние книги могут быть в РГАДА или фондах духовных консисторий.

Часть 2. Технический контекст: Запрос данных через API Яндекс.Метрики

Если под «метрикой» вы имеете в виду систему веб-аналитики Яндекс.Метрика, то «запрос в архиве» обычно означает получение исторических (архивных) данных через API отчетов (Reporting API) или Logs API.

Reporting API (Совместимый с интерфейсом)

Позволяет получать агрегированные данные, идентичные тем, что вы видите в веб-интерфейсе. Основной эндпоинт: https://api-metrika.yandex.net/stat/v1/data.

Пример запроса на Python (библиотека tapi-yandex-metrika):

import datetime as dt
from tapi_yandex_metrika import YandexMetrikaStats
import pandas as pd

ACCESS_TOKEN = 'ваш_токен'
COUNTER_ID = 'идентификатор_счетчика'

client = YandexMetrikaStats(access_token=ACCESS_TOKEN)

params = dict(
 ids=COUNTER_ID,
 date1='6daysAgo', # Относительная дата
 date2='today',
 metrics='ym:s:visits,ym:s:users,ym:s:bounceRate,ym:s:pageDepth,ym:s:avgVisitDurationSeconds',
 dimensions='ym:s:date,ym:s:lastSearchEngineRoot,ym:s:lastSearchPhrase', # Поисковые системы и фразы
 sort='-ym:s:date',
 limit=10000,
 accuracy='full' # Точность выборки (full = без сэмплирования, если позволяет тариф)
)

result = client.stats.get(params=params)
df = pd.DataFrame(result.data)
print(df.head)

Logs API (Выгрузка «сырых» неагрегированных данных)

Необходим, если нужны данные по каждому визиту/хиту (ClientID, параметры URL, IP-маски и т.д.). Это аналог «архива» на уровне событий.

• Создается запрос на подготовку логов (POST /management/v1/counter/{counterId}/logrequests).
• Статус проверяется до готовности.
• Скачиваются части (parts) в формате TSV/CSV.

Критические параметры и ограничения (Ловушки)

• Параметр limit: Ограничивает количество строк в ответе. Раньше максимум был 100 000 строк. Сейчас для Reporting API лимит может быть выше, но для надежности используйте пагинацию (offset).
• Параметр receive_all_data=True (в обертках): Не всегда снимает лимиты API. Если данные не выгружаются полностью — проверяйте документацию текущей версии API.
• Сэмплирование (accuracy): На больших данных Метрика сэмплирует. Используйте accuracy=full (если доступно на тарифе) или Logs API для точных данных.
• Токен доступа: Получается через OAuth (Яндекс.Паспорт). Нужен доступ к счетчику (хотя бы «Гость» или «Просмотр»).

Типичные аналитические срезы «из архива»

Часто задаваемые вопросы, решаемые через API:

1. Поисковые фразы и системы: dimensions=ym:s:lastSearchEngineRoot,ym:s:lastSearchPhrase — откуда и по какому запросу пришли.
2. Запросы к конкретным страницам: В интерфейсе: Отчеты → Источники → Поисковые фразы → выбираем страницу в сегменте. В API: добавляем filters=ym:s:startURL==@'example.com/page'.
3. Задержка поиска (Search Latency): Метрика ym:s:searchLatency (если доступна) или анализ через Вебвизор/Logs API. Пример: «выбрано 86 запросов средней длительностью 23,26 мс».

Часть 3. Синтаксис поисковых запросов (Общие принципы)

И в архивных каталогах, и в Яндекс.Метрике (фильтры, сегменты), и в системах мониторинга (PromQL, Lucene) используются похожие операторы булевой логики.

Часть 4. Чек-лист: Как не ошибиться при выборе стратегии

1. Определите сущность: Вы ищете документ о рождении прадеда 1895 г. (Идите в Госархив / ЗАГС) ИЛИ статистику посещений сайта за 2023 год (Идите в API Яндекс.Метрики).
2. Для Архивов (Генеалогия):
   • Уточните год и место до уезда/волости.
   • Проверьте онлайн-каталог архива (Единая государственная архивная фондовая информационная система, сайты конкретных архивов).
   • Ищите сканы онлайн (FamilySearch, Архивы России, Яндекс.Диск архивов, Genealogy-форумы).
   • Пишите официальный запрос с доказательством родства (для < 100 лет).
3. Для API Яндекс;Метрики (Аналитика):
   • Получите OAuth-токен с нужными правами.
   • Выберите API: Reporting (агрегаты, быстро) или Logs API (сырые данные, долго, большой объем).
   • Учитывайте лимиты limit, offset, сэмплирование (accuracy).
   • Для поисковых запросов используйте dimensions=ym:s:lastSearchPhrase и фильтры по URL.

«Запрос метрики в архиве» — задача, требующая точного понимания предметной области.

• В генеалогии успех зависит от точности исходных данных (год, место, конфессия), умения пользоваться онлайн-описанными фондами архивов (ЦГА, региональные) и грамотного составления официального письменного запроса с подтверждением родственных связей.
• В веб-аналитике ключевыми являются знание архитектуры API (Reporting vs Logs), работа с токенами, понимание ограничений по сэмплированию и лимитам строк, а также умение строить правильные dimensions, metrics и filters для получения нужных срезов (поисковые фразы, поведение на страницах).

Используйте приведенные выше шаблоны запросов, примеры кода и таблицу операторов поиска для эффективной работы в любой из этих сфер.