Сервис Directum Document Assembler Service настраивается в конфигурационном файле appsettings.json.

Структура файла:

{

  "Serilog": {
    "MinimumLevel": {
      "Default": "{Минимальный уровень логирования}",
      "Override": {
        "Microsoft": "Warning",
        "Microsoft.AspNetCore": "Information",
        "Microsoft.EntityFrameworkCore": "Error",
        "System": "Error",
        "Elastic.Apm": "Error"
      }
    },
    "Properties": {
      "Application": "DocumentAssemblerService"
    },
    "WriteTo": [
      {
        "Name": "RollingFile",
        "Args": {
          "formatter": "Logger.SmartEcsTextFormatter, Logger",
          "pathFormat": "{Путь до папки с логами}/{Date}.log"
        }
      }
    ]
  },
    "DocumentAssemblerService": {
        "PrefetchCount": "{Максимальное количество одновременно обрабатываемых запросов}"
    },
    "ElasticApm": {
        "ServerUrls": "{Адрес сервиса Directum Elastic APM Service}",
        "TransactionSampleRate": "{Регулярность отправки трейсов в сервис Directum Elastic APM Service}",
        "SpanFramesMinDuration": "{Время, в течение которого в лог файл записывается подробная информация об ошибке обработки документа. Указывается в миллисекундах}",
        "MetricsInterval": "{Интервал сбора метрик в секундах}",
        "CaptureBody": "all",
        "CaptureBodyContentTypes": "*"
    },
    "Queues": {
      "MessageTTL": "{Время хранения сообщений об обработке в RabbitMQ в секундах}",
      "QueueConnection": "{Строка подключения к RabbitMQ}",
      "RetryConnectionCount": "{Количество повторных попыток подключения к RabbitMQ}"
  }
}

Serilog – параметры ведения лог-файлов:

•MinimumLevel. Минимальный уровень логирования. Значение по умолчанию:

  "Serilog": {

    "MinimumLevel": {
      "Default": "{Минимальный уровень логирования}",
      "Override": {
        "Microsoft": "Warning",
        "Microsoft.AspNetCore": "Information",
        "Microsoft.EntityFrameworkCore": "Error",
        "System": "Error",
        "Elastic.Apm": "Error"
      }
    },

При указанном значении параметра в лог-файл записываются сообщения о каждом этапе обработки документа, а также ошибки, возникающие при работе сервиса.

Подробнее об изменении значения параметра см. на сервисе GitHub в документации библиотеки Serilog;

•WriteTo. Формат хранения лог-файлов, где:

•pathFormat. Путь до папки с лог-файлами.

DocumentAssemblerService – настройки сервиса:

•PrefetchCount. Максимальное количество одновременно обрабатываемых сервисом запросов. Значение по умолчанию 1.

ВАЖНО. Значение параметра PrefetchCount должно совпадать со значением аналогичного параметра в конфигурационном файле сервиса Directum Text Extractor Service. Это необходимо для корректной работы сервисов с метаданными.

ElasticApm – настройка подключения к сервису Directum Elastic APM Service:

•ServerUrls. Адрес сервиса Elastic APM Service;

•TransactionSampleRate. Регулярность отправки трейсов в Elastic APM Service. Укажите значение 1.0, если необходимо отправлять все трейсы, 0.5 – если каждый второй. Значение по умолчанию 1.0;

•SpanFramesMinDuration. Если при обработке документа возникла ошибка и время обработки превышает значение параметра, в лог-файл записывается не только факт ошибки, но и подробная информация о ней. Значение по умолчанию 0ms, при котором подробная запись информации об ошибке в лог-файл отключена;

•MetricsInterval. Интервал сбора метрик о состоянии памяти и CPU. Значение по умолчанию 0s, при котором метрики не собираются;

•CaptureBody. Сообщения, которые передаются в сервис Elastic APM Service. Возможные значения:

•off – сообщения не передаются;

•errors – сообщения с ошибками;

•transactions – сообщения без ошибок;

•all – все сообщения.

Значение по умолчанию all.

Queues – настройка для очередей RabbitMQ:

•MessageTTL. Время хранения сообщений об обработке документов в RabbitMQ в секундах. Значение по умолчанию 86400;

•QueueConnection. Строка подключения к брокеру сообщений RabbitMQ в формате amqp://{Имя пользователя}:{Пароль}@{Адрес}:{Порт}/{Virtual Host}, где:

•Virtual Host – виртуальный тенант RabbitMQ. Подробнее см. в документации RabbitMQ статью Virtual Hosts.

Пример значения: amqp://ario:ario12345@localhost:5672/ario;

•RetryConnectionCount. Количество повторных попыток подключения к брокеру сообщений. Значение по умолчанию 5.

© Компания Directum, 2024