Skip to content

Virtual Machine Archive Snapshot Usage

HyperCloud adds a new tag to the VM monitoring data returned by the orchestrator API calls one.vm.monitoring and one.vm.info. This tag is called HYPERCLOUD_ARCHIVE_SNAPUSAGE. It contains base64-encoded zlib-compressed JSON. Example data:

<VM>
    <MONITORING>
        <HYPERCLOUD_ARCHIVE_SNAPUSAGE>
            <![CDATA[eJy91bFugzAQBuA9T1ExY+G7szHkATpl7VRVESJWE4lCFUOkNsq7lxSGBlB1qi5lgsX+hP/7fY6KY7k/nPw21MV72DfttgvFq4/Wz6tzVBdv/dtDFGidJGXVdLvg/U4FUq0PrYKkKurSV02bULxvumP1ERdd26gTquFToUatHenroyhuaq9AkdLx49NmE8X90ofP7y3AoDZEuYkuq1h0Z5js/KvwJ8mRc+Iaw9TAVAPOmlyc45gcM+OA0VackzM5bsbRlIE0B5DJyaccRKdJnGN5nIF998MCZnYG9t0PC5lzDrPsoE6t+N9B4nFwPuia8kyY06/J5NCU05cypeKclMUZ2bf3hBFvZdAZk5P+R5SB2Tsj+4aTWSfdOwC87MBi75D0nXXtsr9yrCXpQQdmKy9x8pTks8OcrDkHyaH4ZDEviTFjS1F+uXwBehMeLA==]]>
        </HYPERCLOUD_ARCHIVE_SNAPUSAGE>
    </MONITORING>
</VM>

Which is then parsed into:

[lancelot] root@hypercloud-dashboard:~# hypercloud vm show 3 | grep HYPERCLOUD_ARCHIVE_SNAPUSAGE | awk '{print $NF}' | base64 -d | openssl zlib -d
{
   "archive_snapshot_usage" : [
      {
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007300000-3,one-1-3-0,FULL",
         "size" : "142043394"
      },
      {
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007300100-3,one-1-3-0,auto-v2-hourly-202007300000-3",
         "size" : "7377"
      },
      {
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007300400-3,one-1-3-0,auto-v2-hourly-202007300100-3",
         "size" : "17549"
      },
      {
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007300700-3,one-1-3-0,auto-v2-hourly-202007300400-3",
         "size" : "11405"
      },
      {
         "size" : "10381",
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007300900-3,one-1-3-0,auto-v2-hourly-202007300700-3"
      },
      {
         "size" : "22703",
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007301200-3,one-1-3-0,auto-v2-hourly-202007300900-3"
      },
      {
         "size" : "11405",
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007301500-3,one-1-3-0,auto-v2-hourly-202007301200-3"
      },
      {
         "size" : "10381",
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007301700-3,one-1-3-0,auto-v2-hourly-202007301500-3"
      },
      {
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007302100-3,one-1-3-0,auto-v2-hourly-202007301700-3",
         "size" : "20655"
      },
      {
         "size" : "10398",
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007302300-3,one-1-3-0,auto-v2-hourly-202007302100-3"
      },
      {
         "size" : "43336",
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007310300-3,one-1-3-0,auto-v2-hourly-202007302300-3"
      },
      {
         "size" : "14477",
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007310600-3,one-1-3-0,auto-v2-hourly-202007310300-3"
      },
      {
         "size" : "10381",
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007310800-3,one-1-3-0,auto-v2-hourly-202007310600-3"
      },
      {
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007311200-3,one-1-3-0,auto-v2-hourly-202007310800-3",
         "size" : "18573"
      },
      {
         "size" : "11439",
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007311300-3,one-1-3-0,auto-v2-hourly-202007311200-3"
      },
      {
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007311400-3,one-1-3-0,auto-v2-hourly-202007311200-3",
         "size" : "15535"
      },
      {
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007311500-3,one-1-3-0,auto-v2-hourly-202007311200-3",
         "size" : "19631"
      },
      {
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007311600-3,one-1-3-0,auto-v2-hourly-202007311200-3",
         "size" : "23727"
      },
      {
         "size" : "18573",
         "name" : "s3://hypercloud-s3-test-1/lancelot/3,hourly,auto-v2-hourly-202007311700-3,one-1-3-0,auto-v2-hourly-202007311300-3"
      }
   ]
}
[lancelot] root@hypercloud-dashboard:~#

Which indicates that there are one full and eighteen incremental archive backups stored in the configured destination S3 bucket with their respective usage information.