`/sys/loggers`

Конечная точка /sys/loggers используется для изменения уровня детализации журнала.

Изменения, внесенные в уровень журнала с использованием этой конечной точки, не сохраняются и будут восстановлены либо до уровня журнала по умолчанию (info), либо до уровня, указанного log_level в starvault.hcl или переменной среды STARVAULT_LOG_LEVEL, после перезагрузки или перезапуска службы StarVault.

1. Изменение уровня детализации всех регистраторов

Метод

Путь

POST

/sys/loggers

1.1. Параметры

level (string: <required>) – задаёт уровень детализации журнала для всех регистраторов. Поддерживаемые значения (в порядке детализации): "trace", "debug", "info", "warn" и "error".

Пример тела запроса:

{
  "level": "debug"
}

Пример запроса:

curl \
  --header "X-Vault-Token: ..." \
  --request POST \
  --data @payload.json \
  http://127.0.0.1:8200/v1/sys/loggers

2. Изменение уровеня детализации одного регистратора

Метод

Путь

POST

/sys/loggers/:name

2.1. Параметры

name (string: <required>) – указывает регистратор, который необходимо изменить (например audit, core, expiration).
level (string: <required>) – задаёт уровень детализации журнала для всех регистраторов. Поддерживаемые значения (в порядке детализации): "trace", "debug", "info", "warn" и "error".

Пример тела запроса:

{
  "level": "debug"
}

Пример запроса:

curl \
  --header "X-Vault-Token: ..." \
  --request POST \
  --data @payload.json \
  http://127.0.0.1:8200/v1/sys/loggers/core

3. Чтение уровеня детализации всех регистраторов

Метод

Путь

GET

/sys/loggers

Пример запроса:

curl \
  --header "X-Vault-Token: ..." \
  http://127.0.0.1:8200/v1/sys/loggers

Пример ответа:

{
    "audit": "trace",
    "core": "info",
    "policy": "debug"
}

4. Чтение уровеня детализации одного регистратора

Метод

Путь

GET

/sys/loggers/:name

Пример запроса:

curl \
  --header "X-Vault-Token: ..." \
  http://127.0.0.1:8200/v1/sys/loggers/core

Пример ответа:

{
    "core": "info"
}

5. Возвращение уровня детализации всех регистраторов к настроенному уровню

Метод

Путь

DELETE

/sys/loggers

Пример запроса:

curl \
  --header "X-Vault-Token: ..." \
  --request DELETE \
  http://127.0.0.1:8200/v1/sys/loggers

6. Возвращение уровеня детализации отдельного регистратора к настроенному уровню

Метод

Путь

DELETE

/sys/loggers/:name

6.1. Параметры

name (string: <required>) – указывает регистратор, который необходимо изменить (например audit, core, expiration).

Пример запроса:

curl \
  --header "X-Vault-Token: ..." \
  --request DELETE \
  http://127.0.0.1:8200/v1/sys/loggers/core