VoIP.info Guide

PBX logs and packet captures: useful evidence with limited exposure

Collect enough to diagnose a call while protecting identities, secrets and audio.

Reviewed 2026-10-18Foundational

A trace can reveal more than an error

SIP logs may contain numbers, names, addresses and authentication-related material. Media captures can contain conversation content when decodable. Recordings and voicemail have their own access and retention implications.

Scope the collection

Capture one reproducible call or a narrow incident interval. Note the timestamp, direction and affected leg. Prefer read-only status checks before enabling broad protocol logging on a busy PBX.

Preserve diagnostic value when redacting

Remove secrets and private identities while keeping relationships consistent. A sanitized address should refer to the same participant throughout the extract. Keep methods, response order and relevant SDP structure so the recipient can still understand the failure.

Finish the investigation cleanly

Restore previous logging levels and remove temporary collection rules. Store retained evidence under the organization's access and retention policy. Do not upload complete archives to public forums when a short sanitized exchange would answer the technical question.

Keep FreePBX log access and retention inside the privacy boundary

The FreePBX Asterisk Logfile Settings guide scopes logger levels, files, rotation and temporary capture while preserving the module security-update and administrator-access boundary.

Govern facility snapshots, video and door events

A GSC3570 can involve local storage, camera snapshots, SIP history and alarm or door actions. Define collection, access, export, retention and deletion per data type; a removable card or optional file service is not an automatic evidence or privacy programme.

Govern 2N video, credential and access evidence separately

A 2N IP Verso 2.0 deployment may add camera, mobile, RFID, fingerprint, keypad and management records, while an IP One has a different fixed role. Define collection, retention, access and export for each data type; a device event is not proof of the person or final door state.

Bound SessionTalk push logs and caller data

SessionTalk says the push message contains some caller details and recommends a narrow SIP log for troubleshooting. The diagnostic limits capture, redacts identities and secrets, and restores logging after the reproduction.

Bound and dispose of in-memory SIP history

The PJSIP History guide treats retained SIP headers, SDP, identities, addresses and authentication material as restricted incident evidence.

Treat labels and build properties as operational data

The Prometheus metrics guide inventories exposed build, node, channel and bridge labels, restricts access and avoids copying credentials or unrestricted metric output into tickets.

Keep credentials and returned rows out of troubleshooting records

The func_odbc diagnostic retains timing, status and error-class evidence while redacting credentials, sensitive query values and customer rows.

Record transaction evidence without copying sensitive rows

The ODBC mutation diagnostic keeps IDs, status classes, timing and counts while redacting credentials and customer data.

Protect PJSIP Realtime evidence

The PJSIP Realtime diagnostic keeps object identity and error classes useful while redacting database credentials, auth material and customer configuration values.

Protect periodic-hook call evidence

The periodic-hook diagnostic retains hook and channel correlation while redacting caller data and secrets.

Keep secrets and excess personal data out of UserEvent

The AMI UserEvent guide uses opaque references, bounded logs and retention for custom headers.

Protect security-event evidence across every destination

Asterisk security records can contain account, session and address context. Follow the security-event guide and retain only the fields and custody required for the investigation.

Protect PhonerLite profiles, history and recordings separately

sipper.ini can contain reusable credentials, while the logbook, contacts, WAV files and transcripts carry different data. The diagnostic preserves custody for each.

Sanitize Linphone support logs before sharing

Linphone asks for version, reproduction and logs but warns against exposing passwords and other private data. The local-data guide preserves an internal original while bounding any support copy or upload.

Sources & applicability

Primary references for the technical details above. Operational examples and planning checklists are VoIP.info editorial guidance.