list_destinations
List Log Destinations
List all log destinations configured in Papertrail. Log destinations define where systems should send their logs. Destinations can accept logs via syslog (TCP/UDP/TLS) or HTTPS.
list_destinations
List all log destinations configured in Papertrail. Log destinations define where systems should send their logs. Destinations can accept logs via syslog (TCP/UDP/TLS) or HTTPS.
create_group
Create a new group of systems. Groups can include specific systems by ID and/or use a wildcard pattern to automatically include matching systems by name (e.g., `*prod*`).
list_archives
List all available log archive files. Archives are hourly gzipped TSV files containing permanent log records. Returns download URLs for each archive.
delete_group
Delete a group from Papertrail. The systems within the group are not deleted, only the grouping is removed.
list_systems
List all systems (log senders) registered in Papertrail. Returns each system's name, hostname, IP address, last event timestamp, and syslog connection details. Useful for identifying active senders and those that have stopped logging.
update_system
Update an existing system's name, hostname, or IP address. Note that the log destination cannot be changed after creation.
list_groups
List all groups in Papertrail. Groups are sets of systems (log senders) that can be searched together. Each group includes its member systems and optional wildcard pattern for automatic system matching.
remove_user
Remove a team member from the Papertrail account. This revokes their access immediately.
delete_saved_search
Delete a saved search and any associated alerts. This action cannot be undone.
manage_group_membership
Add or remove a system from a group. A system can belong to multiple groups simultaneously.
delete_system
Remove a system (log sender) from Papertrail. This permanently unregisters the system; it will no longer appear in groups or searches.
create_system
Register a new system (log sender) in Papertrail. You can configure the system to log to a specific destination by port or destination ID. For standard syslog port (514), provide the system's static public IP address instead.
get_group
Get details of a specific group including its member systems and wildcard configuration.
update_group
Update a group's name or wildcard pattern. To add or remove systems from a group, use the "Manage Group Membership" tool instead.
invite_user
Invite a new team member to the Papertrail account by email. Configure their permission level including read-only access, member management, billing management, log purging, and group access restrictions.
list_users
List all team members on the Papertrail account. Returns each user's ID and email address.
search_events
Search for log events across systems and groups. Supports Papertrail's full query syntax including Boolean operators (AND, OR), negation, quoted phrases, and attribute filters like `sender:` and `program:`. Results can be filtered by system, group, and time range.
create_saved_search
Create a new saved search within a group. Saved searches can be used to set up alerts that notify you when matching log events occur. The query uses Papertrail's search syntax (Boolean operators, quoted phrases, attribute filters).
list_saved_searches
List all saved searches in Papertrail. Saved searches are named queries associated with a group that serve as the basis for setting up alerts.
get_account_usage
Retrieve Papertrail account information and usage data, including the account name, plan details, and log volume consumed.
update_saved_search
Update an existing saved search's name, query, or group scope.
Search, manage, and archive centralized logs from applications, servers, and cloud platforms. Search log events with Boolean queries and attribute filters, live-tail logs in real time, manage systems (log senders) and groups, create and manage saved searches with alerting, download hourly log archives, manage log destinations, invite and manage team members, and retrieve account usage information. Receive webhook notifications when saved search alerts are triggered by matching or missing log events.
Common questions about connecting Papertrail to AI agents with Metorial.