Amazon Monitron is no longer open to new customers. Existing customers can continue to use the service as normal. For capabilities similar to Amazon Monitron, see our [blog post](https://aws.amazon.com/blogs/machine-learning/maintain-access-and-consider-alternatives-for-amazon-monitron).
# Projects
A *Project* is the foundation for using Amazon Monitron. A project is where your team sets up the gateways, assets, and sensors that Amazon Monitron uses to detect the abnormal conditions that can lead to equipment failure.
An Amazon Monitron Project is structured like this:
Project **→** site or sites **→** assets **→** positions **→** sensors
You can't share these resources between projects. Before you begin creating a project, we recommend that you consider your project's needs. Make sure that it contains all the resources required to predict the maintenance needs for all your assets.
Only a project-level admin user or IT manager can create, update, and delete projects and use the Amazon Monitron console for those tasks.
**Topics**
+ [Creating a project](mp-creating-project.md)
+ [Using tags with your project](tagging.md)
+ [Updating a project](mp-updating-project.md)
+ [Switching between projects](monitron-switch-projects.md)
+ [Deleting a project](mp-delete-project.md)
+ [Additional project tasks](mp-project-tasks.md)
# Creating a project
Although an AWS account can have multiple Amazon Monitron projects, typically you have one per account. The project name must be unique in your AWS account and AWS Region.
**To create a project**
1. Open the Amazon Monitron console at [https://console.aws.amazon.com/monitron](https://console.aws.amazon.com/monitron/).
1. Choose **Create Project**.
1. Under **Project Details**, for **Project name**, enter a name that:
+ Is unique in the current account
+ Consists of uppercase and lowercase letters, numbers, punctuation marks, and spaces
+ Is between 1 and 60 characters
1. By default, Amazon Monitron uses an AWS owned key to encrypt your project through the AWS Key Management Service (AWS KMS). If you want to use a different AWS KMS key, choose **Custom encryption settings (advanced)** under **Data encryption** and do one of the following:
+ If you already have a AWS KMS key that you want to use, under **Choose an AWS AWS KMS key**, choose the key or enter the key's Amazon Resource Name (ARN).
+ If you want to create a key, choose **Create an AWS AWS KMS key**. This takes you to the AWS KMS console so you can set up a custom key.
1. (Optional) To add a tag to the project, enter a key-value pair under **Tags** and then choose **Add tag**. To remove this tag before creating the project, choose **Remove tag**.
1. Choose **Next** to create the project.
# Using tags with your project
A *tag* is a key-value pair that you can use to categorize your projects. For example, if you have multiple projects, you might categorize them by purpose, owner, location, or any other factor.
Use tags to:
+ Organize your projects. You can search and filter by tag. For example, you could add tags such as ‘test lab’ or ‘paint shop' to easily find those projects.
+ Identify and organize your AWS resources. Many AWS services support tagging, so you can assign the same tag to resources in different services to indicate that the resources are related. For example, you can tag a project and the Amazon Simple Storage Service (Amazon S3) bucket that stores related data with the same tag.
+ Control access to your resources. You can use tags in AWS Identity and Access Management (IAM) polices that control access to Amazon Monitron projects. You can attach these policies to an IAM role or user to enable tag-based access control. For more information, see [Controlling access using tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) in the *IAM user Guide*.
Each tag key must be unique within a project.
The following restrictions also apply to Amazon Monitron project tags:
+ The maximum number of tags per project is 50.
+ The maximum length of a tag key is 128 characters.
+ The maximum length of a tag value is 256 characters.
+ Valid characters for keys and values are a–z, A–Z, space, \$1 . : / = \$1 - and @.
+ Tag keys and values are case sensitive.
+ The `aws:` prefix is reserved for AWS use.
+ If you plan to use your tagging schema across multiple services and resources, remember that other services might have different restrictions for valid characters. Refer to the documentation for that service.
**Topics**
+ [Adding a tag to a project when you create it](#tag-original-1)
+ [Adding a tag to a project after it’s been created](#tag-existing-1)
+ [Modifying or removing a tag](#modify-tag-1)
## Adding a tag to a project when you create it
**To add a tag to a project when creating it**
1. Open the Amazon Monitron console at [ https://console.aws.amazon.com/monitron ](https://console.aws.amazon.com/monitron/).
1. Choose **Create Project**.
1. In the navigation pane, choose the project you want.
1. Expand the **Tags** section.
![\[Expand the Tags section to add tags to your project.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/tag-3.png)
1. Choose **Add new tag**.
![\[Tags section showing no associated tags and an "Add new tag" button.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/tag-a.png)
1. Enter the key-value pair for your tag.
The key must be unique for the project. The value is optional.
![\[Enter a key and an optional value in the Tags section.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/tag-1.png)
1. Choose **Add new tag**.
1. To add more tags, repeat steps 2 and 3.
1. To remove a tag, choose **Remove**.
![\[Tag management interface showing a key-value pair for "glass fabrication" and "windshields" with a Remove option.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/tag-b.png)
1. Remove blank tag entries and then choose **Next**.
![\[Tags interface showing a key-value pair for glass fabrication and windshields, with an empty row below.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/tag-c.png)
## Adding a tag to a project after it’s been created
You can add a tag to a project on the project detail page.
**To add a tag to an existing project**
1. Open the Amazon Monitron console at [ https://console.aws.amazon.com/monitron ](https://console.aws.amazon.com/monitron/).
1. Choose **Create Project**.
1. In the navigation pane, choose **Projects**, and then choose the project you want.
1. Under **Tags**, choose **Manage tags**.
![\[Tags section showing a key-value pair for glass fabrication and windshields.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/tag-d.png)
1. Choose **Add new tag**
![\[Tag creation interface with key and value fields, and options to add or remove tags.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/tag-e.png)
1. Enter the key-value pair for your tag.
**Note**
Remember that the key must be unique for the project. The value is optional.
![\[Tags interface showing key-value pairs for AWS resources, with options to add or remove tags.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/tag-f.png)
1. Choose **Save**.
## Modifying or removing a tag
You can modify a tag value, but not a tag key. To change a tag key, remove the tag, then create a new tag with a different key. You can also remove any tag. You modify or remove tags on the project detail page.
**To modify or remove a tag**
1. Open the Amazon Monitron console at [ https://console.aws.amazon.com/monitron](https://console.aws.amazon.com/monitron/).
1. Choose **Create Project**.
1. In the navigation pane, choose **Projects**, and then choose the project you want.
1. Under **Tags**, choose **Manage tags**.
1. To modify the tag value, make the change. To remove the tag, choose **Remove** next to the tag.
![\[Tag creation interface with key and value fields, and options to add or remove tags.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/tag-e.png)
1. Choose **Save**.
# Updating a project
Only the project name can be edited using this procedure. The list of Admin users can also be changed, but you do this using the edit users process.
**To edit a project**
1. Open the Amazon Monitron console at [ https://console.aws.amazon.com/monitron ](https://console.aws.amazon.com/monitron/).
1. Choose **Create Project**.
1. In the navigation pane, choose the project you want to change.
1. From the **Projects** list, choose the project you want to edit.
1. Choose **Edit project**.
1. Edit the project name.
1. Choose **Save**.
# Switching between projects
You can switch between Amazon Monitron projects from both your mobile and web app to manage your resources.
**Note**
You can only be signed in to a single project at a time. When you switch projects you are automatically logged out from the project you were actively using.
When you log into a project using your account credentials, Amazon Monitron automatically adds your project to the Amazon Monitron projects page to make tracking easier. You can also choose to add projects manually to your projects page using the project URL in your Amazon Monitron invitation email.
When you add a project, it gets saved only on the platform you are adding it on. A project added or saved on the Amazon Monitron web app doesn't automatically get saved on the Amazon Monitron mobile app unless you also add it to the web app.
**Topics**
+ [Switching between projects in the web app](#monitron-switch-projects-web)
+ [Switching between projects in the mobile app](#monitron-switch-projects-mobile)
## Switching between projects in the web app
**To switch between projects in the web app**
1. Open the Amazon Monitron console at [ https://console.aws.amazon.com/monitron ](https://console.aws.amazon.com/monitron/).
1. Choose **Open in Amazon Monitron web app**.
![\[Project A dashboard showing setup steps, project details, and admin user management.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/switch-project-console.png)
1. Enter your **Username** and **Password** on the **Sign in** screen.
1. From the **Assets** list page, select your account details dropdown menu, and then choose **View projects**.
![\[Amazon Monitron interface showing asset list, positions, and user account options.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/switch-project-web-app.png)
1. If you want to add a project, choose **Add project** and enter your project link url.
![\[Add project dialog box with a field to enter the project link URL from the console or invitation email.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/switch-project-add-web.png)
1. If you want to switch between projects, choose the project you want to view from the projects list. You will see this message before you switch.
![\[Project switching dialog box explaining single project access and automatic logout/login process.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/project-switching-message-web.png)
## Switching between projects in the mobile app
**To switch between projects in the mobile app**
1. Open the Amazon Monitron mobile app and login using your username and password.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/monitron-switch-projects.html)
1. From the **Assets** list page, select your account details dropdown menu, and then choose **View projects**.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/monitron-switch-projects.html)
1. If you want to add a project, choose **Add project** and enter your project link url.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/monitron-switch-projects.html)
1. If you want to switch between projects, choose the project you want to view from the projects list. You will see this message before you switch.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/monitron-switch-projects.html)
# Deleting a project
With the `deleteProject` operation, you must have the AWS IAM Identity Center permissions for deletion. Without these permissions, the console's delete project functionality will still remove the project. However, it will not remove the resources from IAM Identity Center and you may end up with dangling references on IAM Identity Center.
**To delete a project**
1. Open the Amazon Monitron console at [ https://console.aws.amazon.com/monitron ](https://console.aws.amazon.com/monitron/).
1. Choose **Create Project**.
1. In the navigation pane, choose **Projects**.
1. From the **Projects** list, choose the project you want to delete.
1. Choose **Delete Project**.
1. Enter **Delete** in the confirmation box to confirm the deletion.
If the project contains any active assets, sensors or gateways, you have to remove them before deleting the project. If this is the case, the confirmation box and option to delete don't appear.
If there are active assets or sensors that need to be removed to delete this project, ask an Admin user do this or do it yourself by logging into the *Amazon Monitron mobile app*.
1. Choose **Delete**.
# Additional project tasks
Two common project-related tasks that you might frequently encounter are listing all of your projects and retrieving the details on one specific project. You accomplish both of these tasks using the Amazon Monitron console.
**To list all projects**
1. Open the Amazon Monitron console at [ https://console.aws.amazon.com/monitron ](https://console.aws.amazon.com/monitron/).
1. Choose **Create Project**.
1. In the navigation pane, choose **Projects**.
The list of projects is displayed under **Projects**.
**To get details about a project**
1. Open the Amazon Monitron console at [ https://console.aws.amazon.com/monitron ](https://console.aws.amazon.com/monitron/).
1. Choose **Create Project**.
1. In the navigation pane, choose **Projects**.
The list of projects is displayed under **Projects**.
1. Choose the project that you want to get details on.