Remote monitoring for Amazon S3 compatible storage on Snow Family devices - Amazon Snowball Edge Developer Guide
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Remote monitoring for Amazon S3 compatible storage on Snow Family devices

Remote monitoring allows Amazon to monitor Amazon S3 compatible storage on Snow Family devices on Snowball Edge devices that are connected to an Amazon Web Services Region. When remote monitoring is enabled, it triggers periodic service log uploads to the Amazon Web Services Region. Amazon monitors this information and can proactively notify you when we detect issues with the service. When remote monitoring is not enabled or if the Snowball Edge device or cluster are not connected to an Amazon Web Services Region, the remote monitoring service will not attempt to publish internal device or service telemetry to the cloud. Remote monitoring is available for standalone Snowball Edge devices and clusters of Snowball Edge devices.

Note

Remote monitoring only enables monitoring for the Amazon S3 compatible storage on Snow Family devices service at this time.

You can use the describe-features command to see if the remote monitoring service is running or not. For more information, see Checking feature status in this guide.

To enable remote monitoring for a standalone device

  • Use the set-features command and set the value of the remote-monitoring-state parameter to INSTALLED_AUTOSTART.

    
  snowballEdge set-features /
    --remote-monitoring-state INSTALLED_AUTOSTART
    --manifest-file path/to/manifest.bin
    --unlock-code unlock-code
    --endpoint https://snow-device-local-ip
    Note

    For more information about the manifest file and unlock code of the Snow Family device, see Getting Your Credentials and Tools in this guide.

    The command returns the following.

    
{
    "RemoteMonitoringState" : INSTALLED_AUTOSTART
}
To enable remote monitoring for a cluster of devices

  • Use the set-features command and set the value of the remote-monitoring-state parameter to INSTALLED_AUTOSTART for each Snow Family device in the cluster.

    
  snowballEdge set-features /
    --remote-monitoring-state INSTALLED_AUTOSTART
    --manifest-file path/to/manifest.bin
    --unlock-code unlock-code
    --endpoint https://snow-device-1-local-ip
  snowballEdge set-features /
    --remote-monitoring-state INSTALLED_AUTOSTART
    --manifest-file path/to/manifest.bin
    --unlock-code unlock-code
    --endpoint https://snow-device-2-local-ip
  snowballEdge set-features /
    --remote-monitoring-state INSTALLED_AUTOSTART
    --manifest-file path/to/manifest.bin
    --unlock-code unlock-code
    --endpoint https://snow-device-3-local-ip
    Note

    For more information about the manifest file and unlock code of the Snow Family device, see Getting Your Credentials and Tools in this guide.

    Each time you run the command, it returns the following.

    
{
    "RemoteMonitoringState" : INSTALLED_AUTOSTART
}
To disable remote monitoring for a standalone device

  • Use the set-features command and set the value of the remote-monitoring-state parameter to INSTALLED_ONLY. The Snow Family device will no longer periodically upload logs and Amazon will not monitor nor notify you if issues with the service occur while remote monitoring is disabled.

    
  snowballEdge set-features /
    --remote-monitoring-state INSTALLED_ONLY
    --manifest-file path/to/manifest.bin
    --unlock-code unlock-code
    --endpoint https://snow-device-local-ip

    The command returns the following.

    
{
    "RemoteMonitoringState" : INSTALLED_ONLY
}
To disable remote monitoring for a cluster of devices

  • Use the set-features command and set the value of the remote-monitoring-state parameter to INSTALLED_ONLY for each Snow Family device in the cluster.

    
  snowballEdge set-features /
    --remote-monitoring-state INSTALLED_ONLY
    --manifest-file path/to/manifest.bin
    --unlock-code unlock-code
    --endpoint https://snow-device-1-local-ip
  snowballEdge set-features /
    --remote-monitoring-state INSTALLED_ONLY
    --manifest-file path/to/manifest.bin
    --unlock-code unlock-code
    --endpoint https://snow-device-2-local-ip
  snowballEdge set-features /
    --remote-monitoring-state INSTALLED_ONLY
    --manifest-file path/to/manifest.bin
    --unlock-code unlock-code
    --endpoint https://snow-device-3-local-ip

    Each time you run the command, it returns the following.

    
{
    "RemoteMonitoringState" : INSTALLED_ONLY
}