netbox_get_changelogs
Retrieve and filter NetBox object change records to track modifications, audit activities, and monitor system updates using customizable criteria.
Instructions
Get object change records (changelogs) from NetBox based on filters.
Args: filters: dict of filters to apply to the API call based on the NetBox API filtering options
Returns: List of changelog objects matching the specified filters
Filtering options include:
user_id: Filter by user ID who made the change
user: Filter by username who made the change
changed_object_type_id: Filter by ContentType ID of the changed object
changed_object_id: Filter by ID of the changed object
object_repr: Filter by object representation (usually contains object name)
action: Filter by action type (created, updated, deleted)
time_before: Filter for changes made before a given time (ISO 8601 format)
time_after: Filter for changes made after a given time (ISO 8601 format)
q: Search term to filter by object representation
Example: To find all changes made to a specific device with ID 123: {"changed_object_type_id": "dcim.device", "changed_object_id": 123}
To find all deletions in the last 24 hours: {"action": "delete", "time_after": "2023-01-01T00:00:00Z"}
Each changelog entry contains:
id: The unique identifier of the changelog entry
user: The user who made the change
user_name: The username of the user who made the change
request_id: The unique identifier of the request that made the change
action: The type of action performed (created, updated, deleted)
changed_object_type: The type of object that was changed
changed_object_id: The ID of the object that was changed
object_repr: String representation of the changed object
object_data: The object's data after the change (null for deletions)
object_data_v2: Enhanced data representation
prechange_data: The object's data before the change (null for creations)
postchange_data: The object's data after the change (null for deletions)
time: The timestamp when the change was made
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filters | Yes |
Implementation Reference
- server.py:229-276 (handler)The handler function implementing the 'netbox_get_changelogs' tool logic. It uses the global 'netbox' client to query the NetBox API's 'core/object-changes' endpoint with the provided filters. The @mcp.tool() decorator also serves as the registration for this MCP tool.
@mcp.tool() def netbox_get_changelogs(filters: dict): """ Get object change records (changelogs) from NetBox based on filters. Args: filters: dict of filters to apply to the API call based on the NetBox API filtering options Returns: List of changelog objects matching the specified filters Filtering options include: - user_id: Filter by user ID who made the change - user: Filter by username who made the change - changed_object_type_id: Filter by ContentType ID of the changed object - changed_object_id: Filter by ID of the changed object - object_repr: Filter by object representation (usually contains object name) - action: Filter by action type (created, updated, deleted) - time_before: Filter for changes made before a given time (ISO 8601 format) - time_after: Filter for changes made after a given time (ISO 8601 format) - q: Search term to filter by object representation Example: To find all changes made to a specific device with ID 123: {"changed_object_type_id": "dcim.device", "changed_object_id": 123} To find all deletions in the last 24 hours: {"action": "delete", "time_after": "2023-01-01T00:00:00Z"} Each changelog entry contains: - id: The unique identifier of the changelog entry - user: The user who made the change - user_name: The username of the user who made the change - request_id: The unique identifier of the request that made the change - action: The type of action performed (created, updated, deleted) - changed_object_type: The type of object that was changed - changed_object_id: The ID of the object that was changed - object_repr: String representation of the changed object - object_data: The object's data after the change (null for deletions) - object_data_v2: Enhanced data representation - prechange_data: The object's data before the change (null for creations) - postchange_data: The object's data after the change (null for deletions) - time: The timestamp when the change was made """ endpoint = "core/object-changes" # Make API call return netbox.get(endpoint, params=filters)