loggun 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a78f3c782857269e283aa2f00ef6f5a2002e57c1e0d2fe5d43284a54d5aa106
-  data.tar.gz: fb9d8dad64af86d1f43c510dc34c1fd3acb9a515441315973ab0a5b72d493099
+  metadata.gz: cfd41231567df2c15cca3c6ba500fc8228dcf03ac808b2adb452385be59d4217
+  data.tar.gz: 86c26424200b7c443a4160770d7b3f0d22490db5e0ac3c41fffdd2dadd795d9e
 SHA512:
-  metadata.gz: e0d93bbbe8ed26b5c5decc4d88c16876d4db185d5ae415b07fb47a23848149183e56fb0be6128f8c321410d205d19778228888f9cdb7ce57414ba29c380f22db
-  data.tar.gz: '08d78b02426b5b3da9a31b90bf3715c9728de0eaeb40ed9d5b55ccfeab76c3e241146fcdaa9f052b11ee233a40fdb07e68be5f33ff4a104467cbd08b959fe07a'
+  metadata.gz: '058933cfb04111fe6f0f106e97efde068932b575bfc2be6bdfee0f419db586b07e0a11025eba01b65d12f71a9ef8121dc88e4c53dc39037cd95d5ee6d1ccd90b'
+  data.tar.gz: ebd06ae4867bb4b8cc03fa0ef1815ca73f58af294fab484f3f1207c01d3b4c305cfaa442a6b82771524a909fdb88cb68a8421c760ba8099731957a158c910858

data/.travis.yml

@@ -3,8 +3,6 @@ sudo: false
 language: ruby
 cache: bundler
 rvm:
-  - 2.3.8
-  - 2.4.6
   - 2.5.5
   - 2.6.5
 before_install: gem install bundler

data/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+## 0.4.1 - 2020-07-28
+* fixes
+  * fill type with class name for empty `log_entity_name`
+
+## 0.4.0 - 2020-06-02
+* fixes
+  * fix key_value join character to space
+  * fix dummy dependency alerts
+* features
+  * add new const MESSAGE_FORMATS and test for checking the value of message_format
+  * add check message_format
+  * boolean flag replace with a whitelist and create method for generating a message
+  * added ability to log messages format k=v
+
+## 0.3.1 - 2020-04-21
+* fixes
+  * fix error "modify frozen String" for class name in helpers
+
+## 0.3.0 - 2020-04-17
+* fixes
+  * make public #generate_log_transaction_id in helper
+  * removed incoming http modifier
+
+## 0.2.0 - 2020-04-13
+* fixes
+  * fix Readme with active_record modifier
+  * fix except option for helper #log_options
+  * refactor helpers #log_type
+  * fix helper define log_methods caller
+  * improve stability of helpers
+* features
+  * remove legacy agent from default log pattern
+  * new active record modifier
+  * improve sidekiq modifier for difference versions

data/README.md

@@ -1,34 +1,52 @@
 # Loggun
 
-[![Sponsored by FunBox](https://funbox.ru/badges/sponsored_by_funbox_compact.svg)](https://funbox.ru)
-
 [![Gem Version](https://badge.fury.io/rb/loggun.svg)](https://badge.fury.io/rb/loggun)
 [![Build Status](https://travis-ci.org/funbox/loggun.svg?branch=master)](https://travis-ci.org/funbox/loggun)
 
-## Описание
-Loggun - это гем, позволяющий привести все логи приложения к единому формату
+Приводит логи приложения к единому формату.
+
+## Содержание
+
+- [Установка](#установка)
+- [Использование](#использование)
+- [Конфигурация](#конфигурация)
+  - [Настройки](#настройки)
+  - [Модификаторы](#модификаторы)
+    - [Rails модификатор](#rails-модификатор)
+    - [Active Record модификатор](#active-record-модификатор)
+    - [Sidekiq модификатор](#sidekiq-модификатор)
+    - [Clockwork модификатор](#clockwork-модификатор)
+    - [Модификатор исходящих HTTP-запросов](#модификатор-исходящих-http-запросов)
+    - [Модификатор входящих запросов в Rails](#модификатор-входящих-запросов-в-rails)
+    - [Пользовательские модификаторы](#пользовательские-модификаторы)
+  - [Хелперы](#хелперы)
 
 ## Установка
 
-Чтобы установить гем, добавьте в ваш Gemfile:
+Чтобы установить гем, добавьте его в Gemfile:
 
 ```ruby
 gem 'loggun'
 ```
 
-И выполните команду :
+И выполните команду:
 
-    $ bundle
+```bash
+$ bundle
+```
 
 ## Использование
-Вы можете использовать Loggun как обертку для вашего Logger. Для этого необходимо передать
-ему инстанс вашего логгера и настроить его formatter:
+
+Loggun можно использовать как обертку для вашего `logger`. Для этого необходимо передать
+ему инстанс логгера и настроить его `formatter`:
+
 ```ruby
 Loggun.logger = Rails.logger
 Loggun.logger.formatter = Loggun::Formatter.new
 ```
 
-Теперь вы можете использовать Loggun для логгирования в стандартизированном формате:
+Теперь можно использовать Loggun для логирования в стандартизированном формате:
+
 ```ruby
 Loggun.info('http_request.api.request', user_id: current_user.id)
 #=> 2020-04-11T22:35:04.225+03:00 - 170715 INFO http_request.api.request - {"user_id": 5465}
@@ -37,12 +55,9 @@ Loggun.info('http_request.api.response', user_id: current_user.id, success: true
 #=> 2020-04-11T22:35:04.225+03:00 - 170715 INFO http_request.api.response - {"user_id": 5465, "success": true} 
 ``` 
 
-Подробнее об конфигурации и использовании Loggun ниже.
-
-### Конфигурация
-Для успешной конфигурации гема необходимо подгружать файл при инициализации вашего приложения.
+## Конфигурация
 
-`config/initializers/loggun.rb`
+Конфигурацию гема необходимо производить при инициализации приложения. Например, так:
 
 ```ruby
 Loggun::Config.configure do |config|
@@ -58,38 +73,81 @@ Loggun::Config.configure do |config|
   config.modifiers.outgoing_http = false
 end
 ```
-Все настройки являются опциональными.
-#### Настройки
-- `precision` - точность отметок времени. По умолчанию - `milliseconds`. Может принимать одно из следующих значений: `sec`, `seconds`, `ms`, `millis`, `milliseconds`, `us`, `micros`, `microseconds`, `ns`, `nanos`, `nanoseconds`
-- `pattern` - текстовый шаблон для формата вывода данных в лог. 
-Доступные ключи: `time`, `pid`, `severity`, `type`, `tags_text`, `message`, `parent_transaction`
-- `parent_transaction_to_message` - признак необходимости добавлять значение `parent_transaction` в тело логируемого сообщения. 
-Вне зависимости от данной настройки можно использовать ключ `parent_transaction` в шаблоне `pattern`. 
-- `message_format` - формат переменной message в шаблоне pattern. Доступны два формата: 
-  - `:json` - `message` логгируется как json строка
-  - `:key_value` - `message` логгируется в формате `key1=value1 key2=value2` 
-- `modifiers` - модификаторы для переопределения формата логирования указанного компонента. См. далее.
-
-#### Модификаторы
+
+### Настройки
+
+Все настройки опциональны.
+
+- `precision` — точность отметок времени.
+
+  Может принимать одно из следующих значений:
+  `sec`, `seconds`, `ms`, `millis`, `milliseconds`, `us`, `micros`, `microseconds`, `ns`, `nanos`, `nanoseconds`.
+  
+  По умолчанию `milliseconds`.
+
+- `pattern` — текстовый шаблон для формата вывода данных в лог.   
+
+  Доступные ключи внутри шаблона: `time`, `pid`, `severity`, `type`, `tags_text`, `message`, `parent_transaction`.
+
+- `parent_transaction_to_message` — если `true`, то значение `parent_transaction` будет добавлено в тело логируемого сообщения.
+ 
+  Ключ `parent_transaction` в шаблоне `pattern` можно использовать вне зависимости от значения этой настройки. 
+
+- `message_format` — формат переменной `message` в шаблоне `pattern`. 
+
+  Доступные значения:
+   
+  - `:json` — `message` логируется как JSON-строка;
+  - `:key_value` — `message` логируется в формате `key1=value1 key2=value2`.
+ 
+- `modifiers` — модификаторы для переопределения формата логирования указанного компонента. См. «[Модификаторы](#модификаторы)».
+
+### Модификаторы
+
 Каждый модифкатор может быть активирован двумя равнозначными способами:
+
 ```ruby
 config.modifiers.rails = true
 ```
+
 или
+
 ```ruby
 config.modifiers.rails.enable = true
 ```
 
-##### Rails модификатор 
-`config.modifier.rails` - модифицирует форматирование логгера Rails.
+(В качестве примера активируется Rails модификатор, но может быть любой другой.)
+
+#### Rails модификатор 
+
+`config.modifier.rails`
+
+Модифицирует форматирование логгера Rails.
+
+#### Active Record модификатор
+
+`config.modifier.active_record`
+
+Добавляет (именно добавляет, а не модифицирует) нового подписчика на SQL-события.
+
+SQL начинает дополнительно логироваться в Loggun формате, `severity` — `info`. Например:
 
-##### Active Record модификатор
-`config.modifier.active_record` - добавляет (именно добавляет, а не модифицирует) нового подписчика на SQL события.
-SQL начинает дополнительно логгироваться в Loggun формате, severity - info. Например:
 ```text
 2020-04-12T20:08:52.913+03:00 - 487257 INFO storage.sql.query - {"sql":"SELECT 1","name":null,"duration":0.837}
 ```
-Пример настроек:
+
+Дополнительные настройки:
+
+- `log_subscriber_class_name` — имя класса, реализующего логирование SQL-события.
+
+  Необходим метод `#sql`. По умолчанию: `::Loggun::Modifiers::ActiveRecord::LoggunLogSubscriber`.
+
+- `payload_keys` — необходимые ключи в полезной нарзуке. Используется в классе по умолчанию. 
+   
+  Доступные ключи: `%i[sql name duration source]`.
+
+Пример:
+
 ```ruby
 Loggun::Config.configure do |config|
   #...
@@ -99,26 +157,46 @@ Loggun::Config.configure do |config|
   #...
 end
 ```
-- `log_subscriber_class_name` - имя класса, реализующего логирование sql события.
-Необходим метод `#sql`. По-умолчанию `::Loggun::Modifiers::ActiveRecord::LoggunLogSubscriber`
 
-- `payload_keys` - необходимые ключи в полезной нарзуке. Используется в дефолтном классе. Доступные
-ключи: ```%i[sql name duration source]```.
+#### Sidekiq модификатор 
+
+`config.modifiers.sidekiq`
+
+Модифицирует форматирование логгера Sidekiq.
+
+#### Clockwork модификатор
+
+`config.modifiers.clockwork`
+ 
+Модифицирует форматирование логгера Clockwork.
+
+#### Модификатор исходящих HTTP-запросов
+
+`config.modifiers.outgoing_http`
+
+Добавляет логирование исходящих HTTP-запросов. 
+На данный момент поддерживаются только запросы, выполненные с помощью гема `HTTP`.
+
+#### Модификатор входящих запросов в Rails
+
+ `config.modifiers.incoming_http`
+ 
+Добавляет логирование входящих HTTP-запросов для контроллеров Rails.
+
+Может иметь дополнительные настройки:
 
-##### Sidekiq модификатор 
-`config.modifiers.sidekiq` - модифицирует форматирование логгера Sidekiq.
+- `controllers` — массив имён базовых контроллеров, для которых необходимо добавить указанное логирование.
 
-##### Clockwork модификатор
-`config.modifiers.clockwork` - модифицирует форматирование логгера Clockwork.
+- `success_condition` — лямбда, определяющая, содержит ли успех ответ экшена.
 
-##### Модификатор исходящих HTTP запросово
-`config.modifiers.outgoing_http` - добавляет логирование исходящих http запросов. 
-На данный момент поддерживаются только запросы посредством гема `HTTP`.
+  Например: `-> { JSON.parse(response.body)['result'] == 'ok' }`
 
-##### Модификатор входящих запросов в Rails
- `config.modifiers.incoming_http` - добавляет логирование входящих http запросов для контроллеров Rails.
-Данный модификатор может иметь дополнительные настройки, которые устанавливаются следующим образом 
-(приведены значения по умолчанию):
+- `error_info` — лямбда, позволяющая добавить в лог информацию об ошибке, содержащейся в неуспешном ответе экшена. 
+
+  Например: `-> { JSON.parse(response.body)['error_code'] }`
+
+
+Пример (приведены значения по умолчанию):
 
 ```ruby
 Loggun::Config.configure do |config|
@@ -130,26 +208,25 @@ Loggun::Config.configure do |config|
   #...
 end
 ```
-- `controllers` - массив имён базовых контроллеров, для которых необходимо добавить указанное логирование.
 
-- `success_condition` - лямбда, определяющая, содержит ли успех ответ экшена. Например `-> { JSON.parse(response.body)['result'] == 'ok' }`
+**Для Rails 6 и выше данный модификатор может работать некорректно.** 
 
-- `error_info` - лямбда, позволяющая добавить в лог информацию об ошибке, содержащейся в неуспешном ответе экшена. 
-Например `-> { JSON.parse(response.body)['error_code'] }`
+В этом случае можно добавить в требуемый базовый контроллер строку:
 
-**Для Rails 6 и выше данный модификатор может работать некорректно.** 
-В этом случае можно указать в требуемом базовом контроллере строку:
 ```ruby
 include Loggun::HttpHelpers
 ```
+
 Это делает настройки `enable` и `controllers` модификатора безсполезными, 
-однако позволяет гарантированно логировать входящие http запросы.
+однако позволяет гарантированно логировать входящие HTTP-запросы.
 
 Настройки `success_condition` и `error_info` продолжают использоваться и могут быть установлены требуемым образом.
 
-##### Персональные модификаторы
+#### Пользовательские модификаторы
+
 Помимо указанных модификаторов существует возможность добавить собственный. 
-Необходимо уснаследовать его от `Loggun::Modifiers::Base` и указать в методе `apply` все необходимые действия.
+Необходимо уснаследовать его от `Loggun::Modifiers::Base` и указать в методе `apply` все необходимые действия:
+
 ```ruby
 require 'sinatra/custom_logger'
 
@@ -159,7 +236,9 @@ class NewModifier < Loggun::Modifiers::Base
   end
 end
 ```
-Затем необходимо добавить его при конфигурации гема.
+
+Затем необходимо добавить его при конфигурации гема:
+
 
 ```ruby
 Loggun::Config.configure do |config|
@@ -170,10 +249,12 @@ end
 ```
 
 ### Хелперы
-Подключение хелперов в класс позволяет использовать методы логирования `log_info` и `log_error`, 
+
+Подключение хэлперов в класс позволяет использовать методы логирования `log_info` и `log_error`, 
 а также генерировать идентификатор транзации для каждого метода класса.
 
 Например:
+
 ```ruby
 class SomeClass
   include Loggun::Helpers
@@ -187,26 +268,26 @@ class SomeClass
   end
 end
 ```
-При вызове `#download_data` мы получим следующий вывод в лог:
+
+При вызове `#download_data` будет следующий вывод в лог:
+
 ```
 2020-03-04T16:58:38.207+05:00 - 28476 INFO http_request.some_class.download_data#ffg5431_1583323118203 - {"message":["Information"]}
 2020-03-04T16:58:38.208+05:00 - 28476 INFO http_response.some_class.download_data#ffg5431_1583323118203 - {"success": true}
 ```
 
-**Важно**, что с хелпером log_options необходимо использовать только методы вида `log_<severity>`. 
+**Важно**, что с хэлпером `log_options` необходимо использовать только методы вида `log_<severity>`. 
 Методы модуля `Loggun` не будут работать.
 
-Список всех опций хелпера log_options:
-
-- `entity_name` - имя сущности метода, string
-- `entity_action` - действие сущности метода, string
-- `as_transaction` - добавлять уникальный ID транзакции для метода, boolean
-- `transaction_generator` - собственный генератор ID транзакции, lambda
-- `log_all_methods` - признак необходимости применения хелпера ко всем методам, boolean
-- `only` - список методов, для которых необходимо применить хелпер (работает только если `log_all_methods` - false), Array{Symbol}
-- `except` - список методов, которые надо исключить для хелпера, Array{Symbol}
-- `log_transaction_except` - список методов, логирование которых не нужно обогащать ID транзакции, Array{Symbol}
+Список всех опций хэлпера `log_options`:
 
-## License
+- `entity_name` — имя сущности метода, `string`;
+- `entity_action` — действие сущности метода, `string`;
+- `as_transaction` — добавлять ли уникальный ID транзакции для метода, `boolean`;
+- `transaction_generator` — собственный генератор ID транзакции, `lambda`;
+- `log_all_methods` — применять ли хэлпер ко всем методам, `boolean`;
+- `only` — список методов, для которых необходимо применить хэлпер (работает только когда `log_all_methods = false`), `Array{Symbol}`;
+- `except` — список методов, которые надо исключить для хэлпера, `Array{Symbol}`;
+- `log_transaction_except` — список методов, логирование которых не нужно обогащать ID транзакции, `Array{Symbol}`.
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+[![Sponsored by FunBox](https://funbox.ru/badges/sponsored_by_funbox_centered.svg)](https://funbox.ru)

data/lib/loggun/helpers.rb

@@ -139,7 +139,9 @@ module Loggun
       type_as_arr = type.split('.')
 
       if type_as_arr.size == 1
-        log_entity_name = klass.respond_to?(:log_entity_name) ? klass.log_entity_name : underscore(klass.name.dup)
+        log_entity_name = klass.log_entity_name if klass.respond_to?(:log_entity_name)
+
+        log_entity_name ||= underscore(klass.name.dup)
         type_as_arr << log_entity_name
       end
 

data/lib/loggun/version.rb

@@ -1,3 +1,3 @@
 module Loggun
-  VERSION = '0.4.0'.freeze
+  VERSION = '0.4.1'.freeze
 end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: loggun
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Aleksandr Noskov
 - Sergey Nesterov
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-06-02 00:00:00.000000000 Z
+date: 2020-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -134,6 +134,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -167,7 +168,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/funbox/loggun
   source_code_uri: https://github.com/funbox/loggun
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -183,7 +184,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.0.6
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Loggun
 test_files: []