Manage private locations and checkpoints

Manage private locations

You can manage your private locations and checkpoints from the Private locations menu in the Uptrends web application.

Add private locations

To add a private location:

1. Click Add location.
2. Enter the name for the new private location.
3. Select the monitor group to track. This creates a health monitor for the private location status.
4. Click Add private location.

Once created, two unconfigured and uninstalled checkpoints are added by default. You can install and host these checkpoints on servers to run monitoring checks within your network. You can also add more checkpoints later.

Rename a private location

1. Click to edit the name.
2. Enter the new name.
3. Press Enter to save.

Remove a private location

1. Click to delete a private location.
2. Click Confirm.

All associated checkpoints will also be deleted.

Set private location permissions

Operators and operator groups may have different levels of access to private locations and their checkpoints. Controlling these permissions is essential for security and privacy.

To manage private location permissions:

1. Go to Account setup > Operators and groups.
2. Select the operators or groups to manage permissions for.
3. Go to the Permissions tab.
4. Select whether operators and groups can:
   • Create private locations — view and create private locations.
   • Use private locations — use private locations as checkpoints for monitors.
   • Edit private locations — access, edit, and delete private locations, and assign checkpoints to their monitors.

Administrators have full access to permissions by default. Operators with Use or Edit permissions can add private locations as checkpoints in the monitor Checkpoints tab. Those with Create or Edit permissions can access the Private locations menu.

Manage private checkpoints

Install private checkpoints

After creating a private location, two unconfigured checkpoints are added by default. To install and host these checkpoints on your servers, see Install a Docker checkpoint.

Add a private checkpoint

You can add more private checkpoints to your location as needed:

1. Go to Private locations.
2. Click Add checkpoint.
3. Select the monitor group to track. This creates a health monitor for the private location status.
4. Click Add checkpoint.

The checkpoint is now created in the Uptrends web application. To activate it, you must install the checkpoint on your server.

Use a private checkpoint in a monitor

Private checkpoints are not selected by default. You must manually add them to your monitor’s checkpoint selection.

1. Open your monitor editor.
2. Go to Checkpoints and enable Private locations.
3. Select one or more private checkpoints.
4. Click Save to confirm your changes.

Disable a private checkpoint

You can disable a private checkpoint in two ways:

1. Hover over a private checkpoint.
2. Click the button, then select Disable checkpoint.

Alternatively, you can:

1. Click the checkpoint.
2. Click Disable checkpoint.
3. Provide a description of why you’re disabling the checkpoint.
4. Click Disable.

The checkpoint is disabled and unavailable for monitoring.

Enable a private checkpoint

You can enable a checkpoint in two ways:

1. Hover over a private checkpoint.
2. Click , then select Enable checkpoint.

Alternatively, you can:

1. Click the checkpoint.
2. Click Enable checkpoint.

Remove a private checkpoint

You can remove a private checkpoint in two ways:

1. Hover over a private checkpoint.
2. Click button, then select Delete checkpoint.

Alternatively, you can:

1. Click the checkpoint.
2. Click Delete checkpoint.
3. Click Confirm.

The checkpoint is removed, but the private location remains. Deleting a private location deletes all associated checkpoints.

Monitor your own private location

Depending on your network setup, you might need to adjust your firewall to let private locations reach the monitored services.

Always ensure that at least one private checkpoint is available, so Uptrends can monitor your private location. Without available checkpoints, checks will not run, and no alerts will be triggered.

To receive timely alerts about issues with your private checkpoint network, Uptrends automatically creates monitors listed below to track the status and health of your private checkpoints. Make sure to create an alert definition to get notified and informed if a checkpoint goes down.

Troubleshooting

For more troubleshooting tips, see Troubleshoot private locations and Troubleshoot private checkpoints.