Skip to content

Commit

Permalink
Provide concept guide for the Kanto File Upload
Browse files Browse the repository at this point in the history
- Provide information about what is a File Upload and how it works
- Provide an illustration of this concept

Signed-off-by: Antonia Trifonova [email protected]
  • Loading branch information
Trifonova Antonia authored and Trifonova Antonia committed Jun 22, 2022
1 parent 399d1c9 commit 6e4c3f4
Show file tree
Hide file tree
Showing 3 changed files with 24 additions and 0 deletions.
24 changes: 24 additions & 0 deletions web/site/content/docs/concepts/file-upload.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
title: "File upload"
type: docs
description: >
Empower the edge device to upload data to various storage providers.
weight: 4
---

File upload enables sending of files to a backend storage of choice. It can be used both locally and remotely via a desired IoT cloud ecosystem. The following use cases are provided:

* **Storage diversity** - with ready to use integrations with Azure Blob Storage, Amazon S3 and standard HTTP upload
* **Automatic uploads** - with periodically triggered uploads at a specified interval in a given time frame
* **Data integrity** - with an option to calculate and send the integrity check required information
* **Operation monitoring** - with a status reporting of the upload operation

![File upload](/kanto/images/docs/concepts/file-upload.png)

## How it works

It's not always possible to inline all the data into exchanged messages. For example, large log files or large diagnostic files cannot be sent as a telemetry message. In such scenarios, file upload can assist enabling massive amount of data to be stored to the backend storage.

There are different triggers which can initiate the upload operation: periodic or explicit. Once initiated, the request will be sent to the IoT cloud for confirmation or cancellation transferred back to the edge. If starting is confirmed, the files
to upload will be selected according to the specified configuration, their integrity check information can be calculated and the transfer of the binary content will begin. A status report is announced on each step of the upload process
enabling its transparent monitoring.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 6e4c3f4

Please sign in to comment.