Skip to content
Uplinkr

Project Archiving and Data Retention

Overview

Section titled “Overview”

Archiving allows you to:

  • Preserve complete project snapshots (settings, state, and probe data)
  • Maintain historical records for compliance or analysis
  • Organize long-term storage separate from active monitoring

Archive Location

Section titled “Archive Location”

Archived projects are stored in:

storage/app/private/uplinkr/archived/

Archive structure mirrors the original project layout:

archived/
└── <project-name>/
    ├── settings.json
    ├── state.json
    └── probes/
        └── *.json

Creating Archives

Section titled “Creating Archives”

Command

Section titled “Command”
Terminal window
php artisan uplinkr:project:archive --project=my-project

What Gets Archived

Section titled “What Gets Archived”

The archive includes:

  • ✅ settings.json - Complete project configuration
  • ✅ state.json - Alert state at time of archiving
  • ✅ probes/ directory - All probe execution results
  • ✅ Directory structure - Preserved exactly as original

Current Behavior

Section titled “Current Behavior”

Important: Currently, archiving copies data without deleting the source.

Before Archive:
uplinkr/my-project/          ← Original (remains after archive)


After Archive:
uplinkr/my-project/          ← Original (still exists)
archived/my-project/         ← Copy (newly created)

This means:

  • Original project continues to exist and function
  • Archived copy provides a snapshot at archive time
  • You must manually delete the original if desired

Future Enhancements

Section titled “Future Enhancements”

Note: The following features are not currently implemented but may be added in future versions:

  • Automatic deletion - Option to remove source after archiving
  • Selective archiving - Archive only probe data, preserve settings
  • Archive compression - Built-in compression during archiving
  • Retention policies - Automatic archive cleanup based on age
  • Archive listing - Command to view all archived projects
Section titled “Related Topics”