Skip to content

Commit

Permalink
DOCS-1474: Add fleet management use case (#2281)
Browse files Browse the repository at this point in the history
  • Loading branch information
JessamyT authored Dec 5, 2023
1 parent 8a67b5f commit 673b216
Show file tree
Hide file tree
Showing 4 changed files with 55 additions and 3 deletions.
Binary file added assets/use-cases/last-online.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/use-cases/signup.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/fleet/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ menuindent: true
---

The [Viam app](https://app.viam.com) provides fleet management allowing you to work on any number of machines alone or in collaboration with others.
You can manage your and control your fleet of machines from the Viam app, using the [CLI](/fleet/cli/) or using the [cloud API](/build/program/apis/cloud/).
You can manage your and control your fleet of machines from the Viam app, using the [CLI](/fleet/cli/), or using the [cloud API](/build/program/apis/cloud/).

## Work with groups of machines

Expand Down
56 changes: 54 additions & 2 deletions docs/use-cases/manage-fleet.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,58 @@ title: "Manage a fleet of machines"
linkTitle: "Manage a fleet of machines"
weight: 70
type: "docs"
layout: "empty"
canonical: "fleet/"
tags: ["fleet management", "app", "services"]
no_list: true
description: "Use Viam's fleet management capabilities to share and manage access to your robots."
image: "/fleet/locations.png"
imageAlt: "Fleet management"
images: ["/fleet/locations.png"]
---

You can use Viam's cloud-based fleet management tools to monitor and manage access to your fleet of {{< glossary_tooltip term_id="smart-machine" text="smart machines" >}}.

For example, you might have 30 robots in one warehouse and 500 in another.
You can monitor and teleoperate all of the robots from one online dashboard, and grant permission to other users to do the same.
You can grant users different levels of access to individual robots or to groups of robots.

<table>
<tr>
<th>{{<imgproc src="/use-cases/signup.png" class="fill alignright" resize="600x" style="max-width: 350px" declaredimensions=true alt="Viam app signup screen">}}
<b>1. Create an account</b>
<p>Go to the <a href="https://app.viam.com">Viam app</a> and sign up with Google, GitHub, Apple, or an email address.</p>
</th>
</tr>
<tr>
<th>{{<imgproc src="/fleet/locations.png" class="fill alignleft" resize="600x" style="max-width: 400px" declaredimensions=true alt="Two locations within an organization">}}
<b>2. Create organizations and locations</b>
<p>Use <a href="/fleet/organizations/">organizations</a>, and <a href="/fleet/locations/">locations</a> within them, to organize your machines into groups and manage user access.</p>
</th>
</tr>
<tr>
<th>{{<imgproc src="/fleet/app-usage/limit-access.png" class="fill alignright" resize="600x" style="max-width: 350px" declaredimensions=true alt="Limit user access">}}
<b>3. Invite other users and assign permissions</b>
<p>Invite other users to an organization or a location to <a href="/fleet/#use-viam-for-collaboration">share access</a> to the machines within it. Assign each user a role (owner or operator) to manage permissions.</p>
</th>
</tr>
<tr>
<td>{{<imgproc src="/fleet/app-usage/create-robot.png" class="fill alignleft" resize="600x" style="max-width: 450px" declaredimensions=true alt="Create a new robot in the Viam app">}}
<b>4. Configure robots</b>
<p>Users with access to a location can create and collaborate on the <a href="/fleet/machines/">machines</a> within it. You can use {{< glossary_tooltip term_id="fragment" text="fragments" >}} to streamline the process of configuring multiple similar robots.</p>
</td>
</tr>
<tr>
<td>{{<imgproc src="/use-cases/last-online.png" class="fill alignright" resize="600x" style="max-width: 100px" declaredimensions=true alt="Robot last online status indicator in the Viam app.">}}
<b>5. Monitor your fleet</b>
<p>View the status and logs from each robot in the <a href="https://app.viam.com">Viam app</a>, gather robot sensor <a href="/data/">data</a>, and operate machines remotely from the <a href="/fleet/machines/#control"><strong>Control</strong> tab</a>.</p>
</td>
</tr>
</table>

## Next steps

{{< cards >}}
{{% card link="/fleet/" %}}
{{% card link="/fleet/cli/" %}}
{{% card link="/fleet/rbac/" %}}
{{% card link="/tutorials/" %}}
{{< /cards >}}

0 comments on commit 673b216

Please sign in to comment.