Time Machine Analyzer is a Python Application for analyzing the Time Machine Performance by parsing the log files and extracting the backup speed, size and amount of items to copy. With this Python Application you can draw different graphs to visualize the performance of your Time Machine and analyze why and when the Backup gets stuck or takes longer than usual.

1. Create a virtual environment by running the following command:

python3 -m venv env

2. Activate virtual environment

source env/bin/activate

3. Install needed requirements inside the virtual environment by running the following command:

python3 -m pip install -r requirements.txt

To start the Application run the following command after activating the virtual environment:

python3 main.py

After starting the Application you need to enter the time range the analyzer should take into account when parsing the log file:

Enter time range <num>[m|h|d]:

Following input can be given to the Application:

After you are done you can leave the virtual environment by running the command

deactivate

After the Application was running successfully the following three graphs are produced for analyzing the Time Machine:

1. The first graph shows the Copy Speed of the Time Machine in MB/s and items/s to the Time Capsule or any other external drive:

2. The second graph shows how many GBs were already copied to the Backup drive and how much in total needs to be copied:

3. The third graph shows how many items were already copied to the Backup drive and how much items in total needs to be copied:

Besides the three graphs an additional CSV and JSON file is created containing all log entries in the following format:

Type: array

path: #

$schema: https://json-schema.org/draft/2020-12/schema

• Items
• Type: object
• path: #/items
• This schema does not accept additional properties.
• Properties
  • date_time required
    • Type: string
    • path: #/items/properties/date_time
  • bytes_copied required
    • Number of bytes copied to backup drive
    • Type: integer
    • path: #/items/properties/bytes_copied
  • bytes_to_copy required
    • Total number of Bytes to copy to backup drive
    • Type: integer
    • path: #/items/properties/bytes_to_copy
  • items_copied required
    • Number of items to copy to backup drive
    • Type: integer
    • path: #/items/properties/items_copied
  • items_to_copy required
    • Total number of items to copy to backup drive
    • Type: integer
    • path: #/items/properties/items_to_copy
  • bytes_per_second required
    • Copy speed in bytes per second
    • Type: integer
    • path: #/items/properties/bytes_per_second
  • items_per_second required
    • Copy speed in items per second
    • Type: number
    • path: #/items/properties/items_per_second
  • last_path_seen required
    • Last path backed up while this log file was created
    • Type: string
    • path: #/items/properties/last_path_seen

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "TimeMachineLogEntries",
  "type": "array",
  "items": {
    "type": "object",
    "additionalProperties": false,
    "required": [
      "date_time",
      "bytes_copied",
      "bytes_to_copy",
      "items_copied",
      "items_to_copy",
      "bytes_per_second",
      "items_per_second",
      "last_path_seen"
    ],
    "properties": {
      "date_time": {
        "type": "string"
      },
      "bytes_copied": {
        "type": "integer",
        "description": "Number of bytes copied to backup drive"
      },
      "bytes_to_copy": {
        "type": "integer",
        "description": "Total number of Bytes to copy to backup drive"
      },
      "items_copied": {
        "type": "integer",
        "description": "Number of items to copy to backup drive"
      },
      "items_to_copy": {
        "type": "integer",
        "description": "Total number of items to copy to backup drive"
      },
      "bytes_per_second": {
        "type": "integer",
        "description": "Copy speed in bytes per second"
      },
      "items_per_second": {
        "type": "number",
        "description": "Copy speed in items per second"
      },
      "last_path_seen": {
        "type": "string",
        "description": "Last path backed up while this log file was created"
      }
    }
  }
}

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

MIT