Log callid

Description

Records callid relations of SIP dialogs when legs are created (transfers, replacements, forks); sg — callids of passed INVITE dialogs, once per dialog.
Each role records data in its own format corresponding to the part of the process it provides when servicing calls in the system.

A node can contain no more than one SIP protocol servicing role; it forms this log.

Used by the system itself to build callid closures beyond the relation retention time in the microservice cache (all logs preserved on the node are scanned; depth is limited by the days parameter). Used to collect logs for a call and build sequence diagrams. Line format: `key='value'; …​`; in values the characters `%`, ’`, and line feed are encoded (`%25`, `%27`, `%0D`, `%0A`).

Table 1. System characteristics

Category

sip

Type

callid

Configuration mode

Permanent

Binding layer

Process

Forming logical roles

Configuration location

The "log_closure" option in role configuration settings.

In-memory relations and log volume

Callid relations are also stored in the memory of SIP signaling nodes (sip_stat_timeout_closure, default 3.5 hours). With the callid log enabled, closures are also built from it, so in-memory storage is needed:

  • when the log is disabled (log_closure = false);

  • when node logs are deleted before the in-memory retention time expires (under high load — by logging_role_max_size volume);

  • for the current call list of working domains (callid-to-domain relations) — at least sip_stat_timeout_callinfo.

With the log enabled and sufficient log retention, in-memory retention can be reduced, for example to 30 minutes.

Rough estimate for 100 calls per second (simple call: two legs through sg and b2b, no transfers; a call with transfers — 2-3 times more):

Per call 100 calls per second

Memory: closure relations

≈ 2 KB

≈ 2.8 GB over 3.5 hours; at 30 minutes — ≈ 0.4 GB

callid log

≈ 0.4 KB (3 lines)

≈ 3.5 GB per day

trn log

≈ 40 KB (≈ 60 packet copies)

≈ 350 GB per day

Volumes are distributed across SIP signaling nodes. Logs on a node are retained for logging_role_store_days (default 2 days) within logging_role_max_size (default 1 GB per node log type): under such load trn logs are retained for minutes, callid — for hours. Logs already deleted from nodes are searched in logstore with load restrictions: more.