Data Recording¶

Recorder¶

Recorder can be used to record specific data, by configuring and referencing different recorder types to record data to different targets.

services:
- name: service-0
  addr: :8080
  recorders:
  - name: recorder-0
    record: recorder.service.router.dial.address
  handler:
    type: auto
  listener:
    type: tcp

recorders:
- name: recorder-0
  file:
    path: /path/to/recorder/file
    sep: "\n"

Recorder Types¶

Currently supported recorder types are: file, redis.

File¶

File recorder records data to the specified file.

recorders:
- name: recorder-0
  file:
    path: /path/to/recorder/file
    sep: "\n"

file.path (string): file path
sep (string): Record separator. If set, this separator will be inserted between two records

Redis¶

Redis recorder records data to the redis server.

recorders:
- name: recorder-0
  redis:
    addr: 127.0.0.1:6379
    db: 1
    password: 123456
    key: gost:recorder:recorder-0
    type: set

addr (string, required): redis server address
db (int, default=0): database name
password (string): redis password
key (string, required): redis key
type (string, default=set): data type: Set(set), Sorted Set(sset), List(list).

Recorder Usage¶

The list of recorders to use is specified via service.recorders.

services:
- name: service-0
  addr: :8080
  recorders:
  - name: recorder-0
    record: recorder.service.router.dial.address
  - name: recorder-1
    record: recorder.service.router.dial.address.error
  handler:
    type: auto
  listener:
    type: tcp

name (string, required): recorder name
record (string, required): record object

Record Object¶

Currently supported record objects are:

recorder.service.client.address: All client addresses accessing the service
recorder.service.router.dial.address: All visited destination addresses
recorder.service.router.dial.address.error: All destination addresses that failed to establish a connection