本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Deadline 云监视器
<a name="working-with-deadline-monitor"></a>

De AWS adline Cloud 监控器为您提供可视化计算作业的总体视图。您可以使用它来监控和管理作业、查看员工在车队中的活动、跟踪预算和使用情况，以及下载作业结果。

每个队列都有一个作业监视器，可向您显示作业、步骤和任务的状态。监视器提供了直接从显示器管理作业的方法。您可以更改优先级、取消作业、重新排队作业和重新提交作业。

Deadline Cloud 监视器有一个显示任务摘要状态的表格，或者您可以选择一个作业来查看详细的任务日志，以帮助解决作业问题。

您可以使用 Deadline Cloud 监视器将结果下载到工作站上创建任务时指定的位置。

Deadline Cloud 监控器还可以帮助您监控使用情况和管理成本。有关更多信息，请参阅 [追踪 Deadline 云场的支出和使用情况](manage-costs.md)。

**Topics**
+ [共享 Deadline Cloud 监控](share-monitor-url.md)
+ [打开截止日期云监视器](open-deadline-cloud-monitor.md)
+ [提交工作捆绑包](submit-job-bundle-monitor.md)
+ [在截止日期云中查看队列和舰队详情](view-queue-and-fleet.md)
+ [在 Deadline Cloud 中管理作业、步骤和任务](view-jobs-steps-tasks.md)
+ [在 Deadline Cloud 中查看和管理职位详情](view-a-job.md)
+ [在截止日期云中查看步骤](view-a-step.md)
+ [在截止日期云中查看任务](view-a-task.md)
+ [在截止日期云中查看会话和工作人员日志](view-logs.md)
+ [在工作人员控制面板中查看工作人员详细信息](view-worker-dashboard.md)
+ [在截止日期云中下载已完成的输出](download-finished-output.md)
+ [自动化 Deadline 云端监控桌面部署和工作流程](monitor-automate-desktop.md)

# 共享 Deadline Cloud 监控
<a name="share-monitor-url"></a>

设置 Deadline Cloud 服务时，默认情况下，您需要创建一个网址，用于为您的账户打开 Deadline Cloud 监视器。使用此 URL 在浏览器或桌面上打开显示器。与其他用户共享 URL，以便他们可以访问 Deadline Cloud 监视器。

在用户打开 Deadline Cloud 监视器之前，您必须向该用户授予访问权限。要授予访问权限，请将该用户添加到监视器的授权用户列表中，或者将其添加到有权访问监控器的群组中。有关更多信息，请参阅 [在截止日期云中管理用户](managing-users.md)。

**共享监视器 URL**

1. 打开[截止日期云控制台](https://console.aws.amazon.com/deadlinecloud/home)。

1. 从 “**开始**” 中，选择 “**前往截止日期云控制面板”**。

1. 在导航窗格上，选择 **Dashboard**。

1. 在**账户概述**部分，选择**账户详情**。

1. 复制 **URL**，然后安全地将其发送给需要访问 Deadline Cloud 监控器的任何人。

# 打开截止日期云监视器
<a name="open-deadline-cloud-monitor"></a>

您可以通过以下任何一种方式打开 Deadline Cloud 监视器：
+ **控制台**-登录 AWS 管理控制台 并打开 Deadline Cloud 控制台。
+ **Web** — 转到您在设置 Deadline Cloud 时创建的监视器 URL。
+ **监控**-使用桌面 Deadline Cloud 监视器

使用控制台时，必须能够 AWS 使用 AWS Identity and Access Management 身份登录，然后使用 AWS IAM Identity Center 凭据登录显示器。如果您只有 IAM Identity Center 证书，则必须使用监控 URL 或桌面应用程序登录。

**打开 Deadline Cloud 监视器 (Web)**

1. 使用浏览器打开您在设置 Deadline Cloud 时创建的监视器 URL。

1. 使用您的用户凭据登录。

**打开 Deadline Cloud 监视器（控制台）**

1. 打开[截止日期云控制台](https://console.aws.amazon.com/deadlinecloud/home)。

1. 在导航窗格中，选择**农场**。

1. 选择一个场，然后选择 “**管理作业**” 以打开 De **adline Cloud 监控**页面。

1. 使用您的用户凭据登录。

**打开 Deadline Cloud 监视器（桌面）**

1. 打开[截止日期云控制台](https://console.aws.amazon.com/deadlinecloud/home)。

   –或者–

   从监视器 URL 打开 Deadline Cloud 监视器-Web。

1. 
   + 在 Deadline Cloud 控制台上，执行以下操作：

     1. 在监视器中，选择 “**前往 Deadline Cloud 控制面板**”，然后从左侧菜单中选择 “**下载**”。

     1. 从 De **adline Cloud 监**视器中，为您的桌面选择显示器版本。

     1. 选择**下载**。
   + 在 Deadline Cloud 监视器-网页版上，执行以下操作：
     + 从左侧菜单中选择 “**工作站设置**”。如果工作**站设置**项不可见，请使用箭头打开左侧菜单。
     + 选择**下载**。
     + 从**选择操作系统**中，选择您的操作系统。

1. 下载 Deadline 云监视器-桌面。

1. 下载并安装显示器后，在计算机上将其打开。
   + 如果这是您第一次打开 Deadline Cloud 监视器，则必须提供监视器 URL 并创建配置文件名称。接下来，使用您的 Deadline Cloud 凭据登录显示器。
   + 创建配置文件后，您可以通过选择配置文件来打开显示器。您可能需要输入您的 Deadline Cloud 凭据。

## 更改您的语言设置
<a name="w2aac11c17c15"></a>

创建并打开 Deadline Cloud 监视器后，您可以更改语言设置。默认情况下，显示器语言设置为系统的语言设置。

**从 Deadline Cloud 监视器（桌面）中更改语言设置**

1. 在您的用户个人资料中，选择 “**设置”**，然后选择 “**语言**”。

1. 从下拉菜单中选择一种可用语言。

1. 确认您选择的语言是列出的选项，然后选择**确认并申请**以应用更改。

   显示器刷新后，它将以所选语言显示。

   更改语言设置后，它将在打开时成为默认设置，并且在您再次更改或卸载桌面应用程序之前保持默认设置。

**要更改网络上的 Deadline Cloud 监视器语言，请在浏览器设置中更改首选语言。**

**注意**  
如果您的浏览器或操作系统设置为 Deadline Cloud 不支持的语言，则英语将成为 Deadline Cloud 监视器的默认语言。

# 提交工作捆绑包
<a name="submit-job-bundle-monitor"></a>

您可以直接从 Deadline Cloud 监控器桌面应用程序中提交任务捆绑包。 AWS 任务包是一个目录，其中包含向 Deadline Cloud 提交作业所需的文件和信息。有关任务捆绑包的示例，请参阅上的[deadline-cloud-samples](https://github.com/aws-deadline/deadline-cloud-samples)存储库。 GitHub

**提交工作捆绑包**  

+ 在 Deadline Cloud 监控桌面应用程序中，选择**文件**、**提交 Job Bundle**。此功能在 Linux AppImage 或 macOS x64 版本中不可用。

# 在截止日期云中查看队列和舰队详情
<a name="view-queue-and-fleet"></a>

您可以使用 Deadline Cloud 监控器来查看服务器场中队列和队列的配置。您还可以使用监视器查看队列中的作业或队列中的工作人员的列表。

您必须拥有查看队列和舰队详细信息的`VIEWING`权限。如果未显示详细信息，请联系您的管理员以获取正确的权限。

**查看队列详情**

1. [打开截止日期云监视器](open-deadline-cloud-monitor.md). 

1. 从服务器场列表中，选择包含您感兴趣的队列的服务器场。

1. 在队列列表中，选择一个队列以显示其详细信息。要比较两个或多个队列的配置，请选中多个复选框。

1. 要查看队列中的作业列表，请从队列列表或详细信息面板中选择队列名称。

如果监视器已打开，则可以从左侧导航窗格的**队列**列表中选择队列。

**查看机群详细信息**

1. [打开截止日期云监视器](open-deadline-cloud-monitor.md). 

1. 从农场列表中，选择包含您感兴趣的舰队的农场。

1. 在**农场资源**中，选择**舰队。**

1. 在舰队列表中，选择一个舰队以显示其详细信息。要比较两个或多个舰队的配置，请选中多个复选框。

1. 要查看车队中的工作人员名单，请从舰队列表或详细信息面板中选择车队名称。

**如果监视器已打开，则可以从左侧导航窗格的舰队列表中选择舰队。**

# 在 Deadline Cloud 中管理作业、步骤和任务
<a name="view-jobs-steps-tasks"></a>

选择队列时，Deadline Cloud 监控器的作业监视器部分会显示该队列中的作业、作业中的步骤以及每个步骤中的任务。选择作业、步骤或任务时，可以使用 “**操作**” 菜单来管理每个任务、步骤或任务。

要打开作业监视器，请按照步骤查看队列[在截止日期云中查看队列和舰队详情](view-queue-and-fleet.md)，然后选择要使用的作业、步骤或任务。

对于作业、步骤和任务，您可以执行以下操作：
+ **将状态更改为 “已**重新排队**”、“**成功**”、“**失败**” 或 “已取消”。**
+ 从作业、步骤或任务中下载已处理的输出。
+ 复制作业、步骤或任务的 ID。

对于所选作业，您可以：
+ 将作业存档。
+ 修改作业属性，包括姓名、描述、优先级或最大工作人员数量。
+ 查看步骤到步骤的依赖关系。
+ 使用作业的参数查看更多详细信息。
+ 重新提交作业。

有关更多信息，请参阅 [在 Deadline Cloud 中查看和管理职位详情](view-a-job.md)。

对于每个步骤，您都可以：
+ 查看该步骤的依赖关系。必须先完成步骤的依赖关系，然后才能运行该步骤。

有关更多信息，请参阅 [在截止日期云中查看步骤](view-a-step.md)。

对于每项任务，您可以：
+ 查看任务的日志。
+ 查看任务参数。

有关更多信息，请参阅 [在截止日期云中查看任务](view-a-task.md)。

# 在 Deadline Cloud 中查看和管理职位详情
<a name="view-a-job"></a>

Deadl **ine Cloud 监控器中的 J** ob 监控页面为您提供以下内容：
+ 工作进度的总体视图。
+ 构成任务的步骤和任务的视图。

从列表中选择一个作业以查看该作业的步骤列表，然后从步骤列表中选择一个步骤来查看该作业的任务。选择项目后，您可以使用该项目的 “**操作**” 菜单来查看详细信息。

**查看职位详情**

1. 按照步骤在中查看队列[在截止日期云中查看队列和舰队详情](view-queue-and-fleet.md)。

1. 在导航窗格中，选择您提交作业的队列。

1. 使用以下方法之一选择作业：

   1. 从 “作**业**” 列表中，选择一个作业以查看其详细信息。

   1. 在**搜索**字段中，输入与该作业关联的任何文本，例如作业名称或创建该作业的用户。从显示的结果中，选择要查看的作业。

作业的详细信息包括作业中的步骤和每个步骤中的任务。您可以使用 “**操作**” 菜单执行以下操作：
+ 更改作业的状态。
+ 查看和修改作业的属性。
  + 您可以查看作业中各步骤之间的依赖关系。
  + 您可以更改队列中作业的优先级。优先级较高的作业先处理数字优先级较低的作业。作业的优先级可以介于 1 到 100 之间。当两个作业具有相同优先级时，将首先安排最早的作业。
+ 查看提交作业时为作业设置的参数。
+ 下载任务的输出。下载作业的输出时，它包含作业中的步骤和任务生成的所有输出。

## 存档作业
<a name="view-jobs-steps-tasks-archive"></a>

要存档作业，该作业必须处于终止状态`FAILED`、`SUCCEEDED`、`SUSPENDED`、或`CANCELED`。`ARCHIVED`状态是最终的。任务存档后，无法对其进行重新排队或修改。

存档作业不会影响作业的数据。当达到非活动超时时间或包含任务的队列被删除时，数据就会被删除。

存档作业发生的其他事情：
+ 存档的作业隐藏在 Deadline Cloud 监控器中。
+ 在删除之前，存档的作业在 Deadline Cloud CLI 中以只读状态可见 120 天。

## 重新排队作业
<a name="view-jobs-steps-tasks-requeue"></a>

在重新排队作业时，所有没有步骤依赖关系的任务都会切换到。`READY`具有依赖关系的步骤的状态在恢复时切换`PENDING`为`READY`或在恢复时切换。
+ 所有作业、步骤和任务都会切换到`PENDING`。
+ 如果某个步骤没有依赖关系，则会切换到`READY`。

## 重新提交作业
<a name="view-jobs-steps-tasks-resubmit"></a>

有时您可能想再次运行作业，但要使用不同的属性和设置。例如，您可以提交一个任务来渲染测试帧的子集，验证输出，然后在整个帧范围内再次运行该作业。为此，请重新提交作业。

当你重新提交工作时，没有依赖关系的新任务就会变成`READY`。具有依赖关系的新任务变成`PENDING`。
+ 所有新的作业、步骤和任务都变成`PENDING`。
+ 如果一个新步骤没有依赖关系，它就会变成`READY`。

重新提交作业时，只能更改首次创建作业时定义为可配置的属性。例如，如果首次提交时未将作业名称定义为该作业的可配置属性，则在重新提交时无法编辑该名称。

# 在截止日期云中查看步骤
<a name="view-a-step"></a>

使用 De AWS adline Cloud 监视器查看处理任务中的步骤。**在 **Job 监视器**中，Steps 列表显示构成所选作业的步骤列表。**选择步骤后，**任务**列表会显示该步骤中的任务。

**查看步骤**

1. 按照中的[在 Deadline Cloud 中查看和管理职位详情](view-a-job.md)步骤查看作业列表。

1. 从**作业**列表中选择作业。

1. 从 “步骤” 列表中选择一个**步骤**。

您可以使用 “**操作**” 菜单执行以下操作：
+ 更改步骤的状态。
+ 下载该步骤的输出。下载步骤的输出时，它包含该步骤中任务生成的所有输出。
+ 查看步骤的依赖关系。依赖关系表显示了在选定步骤开始之前必须完成的步骤列表以及等待此步骤完成的步骤列表。

# 在截止日期云中查看任务
<a name="view-a-task"></a>

使用 De AWS adline Cloud 监视器查看处理任务中的任务。在 **Job 监视器**中，**任务**列表显示构成步骤列表中所选**步骤**的任务。

**查看任务**

1. 按照中的[在 Deadline Cloud 中查看和管理职位详情](view-a-job.md)步骤查看作业列表。

1. 从**作业**列表中选择作业。

1. 从 “步骤” 列表中选择一个**步骤**。

1. 从 “任务” 列表中选择一项**任务**。

您可以使用 “**操作**” 菜单执行以下操作：
+ 更改任务的状态。
+ 查看任务日志。有关更多信息，请参阅 [在截止日期云中查看会话和工作人员日志](view-logs.md)。
+ 查看创建任务时设置的参数。
+ 下载任务的输出。下载任务的输出时，它仅包含所选任务生成的输出。

# 在截止日期云中查看会话和工作人员日志
<a name="view-logs"></a>

日志为您提供有关任务状态和处理的详细信息。在 De AWS adline Cloud 监控器中，您可以看到以下两种类型的日志：
+ 会话日志详细说明了操作的时间表，包括：
  + 设置操作，例如同步附件和加载软件环境
  + 运行一项或一组任务
  + 关闭操作，例如关闭工作人员的环境

  一个会话包括对至少一个任务的处理，并且可以包括多个任务。会话日志还显示有关亚马逊弹性计算云 (Amazon EC2) 实例类型、vCPU 和内存的信息。会话日志还包括指向会话中使用的工作器日志的链接。
+ 工作日志提供了工作人员在其生命周期中处理的操作的时间表的详细信息。工作日志可以包含有关多个会话的信息。

您可以下载会话和工作器日志，以便可以离线查看它们。

**查看会话日志**

1. 按照中的[在 Deadline Cloud 中查看和管理职位详情](view-a-job.md)步骤查看作业列表。

1. 从**作业**列表中选择作业。

1. 从 “步骤” 列表中选择一个**步骤**。

1. 从 “任务” 列表中选择一项**任务**。

1. 从 “**操作**” 菜单中选择 “**查看日志**”。

“**时间表**” 部分显示了该任务的操作摘要。要查看会话中运行的更多任务以及会话的关闭操作，请选择**查看所有任务的日志**。

**查看任务中的工作人员日志**

1. 按照中的[在 Deadline Cloud 中查看和管理职位详情](view-a-job.md)步骤查看作业列表。

1. 从**作业**列表中选择作业。

1. 从 “步骤” 列表中选择一个**步骤**。

1. 从 “任务” 列表中选择一项**任务**。

1. 从 “**操作**” 菜单中选择 “**查看日志**”。

1. 选择 “**会话信息”**。

1. 选择 “**查看工作人员日志**”。

**从舰队详细信息中查看工作人员日志**

1. 按照中的步骤[在截止日期云中查看队列和舰队详情](view-queue-and-fleet.md)查看舰队。

1. 从 “**工作人员” 列表中选择**工作人员** ID**。

1. 从 “**操作**” 菜单中选择 “**查看工作人员日志**”。

# 在工作人员控制面板中查看工作人员详细信息
<a name="view-worker-dashboard"></a>

*工作人员仪表板*提供处理任务的工作人员的详细信息。你可以看到：
+ 工作人员的元数据，例如实例类型
+ 工作人员执行的会话操作
+ 工作器性能，包括 CPU、内存和磁盘使用率
+ 一段时间内的 CPU、内存和磁盘使用情况图表
+ 一段时间内磁盘速度的图表
+ 任务的工作日志

**从任务中查看工作人员仪表板**

1. 按照中的[在 Deadline Cloud 中查看和管理职位详情](view-a-job.md)步骤查看作业列表。

1. 从**作业**列表中选择作业。

1. 从 “步骤” 列表中选择一个**步骤**。

1. 从 “任务” 列表中选择一项**任务**。

1. 在任务表中，从 “**操作**” 菜单中选择 “**查看工作人员仪表板**”。

**从车队详细信息中查看工作人员仪表板**

1. 按照中的步骤[在截止日期云中查看队列和舰队详情](view-queue-and-fleet.md)查看舰队。

1. 从 “**工作人员**” 列表中选择**工作人员**。

1. 从 “**操作**” 菜单中选择 “**查看工作人员控制面板**”。

## 使用案例
<a name="use-cases"></a>

### 检测预置不足的实例
<a name="under-provisioned-instances"></a>

当渲染所需的时间超过预期时，工作人员控制面板可以帮助确定您的实例大小是否足以适应您的工作负载。虽然对于许多渲染器来说，100% 的 vCPU 利用率是正常的，但持续的高内存使用率接近最大容量和较高的磁盘空间利用率可能表明您的实例配置不足。在这种情况下，升级队列的实例配置可以减少渲染错误并显著缩短渲染时间。但是，重要的是要在升级后继续监控工作人员的绩效，以确保找到最佳平衡点——过于激进的升级可能会因为过度配置而导致不必要的成本。

### 检测过度配置的实例
<a name="over-provisioned-instances"></a>

即使任务成功完成，也可能有机会优化成本。工作人员仪表板可以显示您支付的计算能力是否超过了工作负载所需的计算能力。如果您发现工作程序的 vCPU 平均使用率较低，内存利用率最低，且未使用的磁盘空间过多，则可以缩小队列的实例配置。

### 故障排除失败的任务
<a name="troubleshooting-failed-tasks"></a>

调查失败的任务时，工作人员仪表板可作为一种有价值的诊断工具。请特别注意峰值内存使用率和磁盘空间利用率——如果这些指标接近或达到 100%，它们很可能是任务失败的根本原因。这种资源耗尽表明您当前的实例缺乏有效处理工作负载的能力。在这些情况下，通过增加内存或磁盘空间来配置实例将有助于确保成功完成任务。

### 最佳实例利用率
<a name="preferred-utilization-rate"></a>

**vCPU 利用率**

**目标射程：70—90%**
+ 低@@ **于 70%**：计算资源可能未得到充分利用，这意味着您为 CPU 支付的费用超过了工作负载需求
+ **70— 90%**：在不遇到瓶颈的情况下高效使用资源的最佳范围
+ **始终保持在 100%**：可能表明 CPU 瓶颈可能会减慢渲染速度

请记住，有些渲染任务自然会比其他渲染任务占用更多的 CPU，而且 100% 的 vCPU 使用率可能不是问题。实时可视化任务可能会显示更一致的 CPU 利用率，而计算要求不断变化的任务可能具有不同的模式。

**内存利用率**

**目标射程：70—85%**
+ **低于 50%**：您的工作负载的实例可能过大
+ **70— 85%**：利用率最佳，有足够的空间容纳峰值
+ **高于 90%**：性能下降或出 out-of-memory错的风险

内存要求可能因场景复杂度、纹理分辨率和仿真数据而有很大差异。监控内存随时间变化的趋势对于确定您的工作负载的内存需求是否在增长非常重要。

**磁盘空间利用率**

**目标射程：60—80%**
+ **低于 40%**：可能存在过度配置的存储空间
+ **60— 85%**：利用率良好，有空间存放临时文件和缓存
+ **高于 85%**：大型渲染期间空间不足的风险

请记住，磁盘 I/O 性能可能与容量一样重要，特别是对于在渲染过程中纹理或缓存文件 read/write 较大的工作负载。

# 在截止日期云中下载已完成的输出
<a name="download-finished-output"></a>

作业完成后，您可以使用 De AWS adline Cloud 监视器将结果下载到您的工作站。输出文件以您在创建作业时指定的名称和位置进行存储。

输出文件无限期存储。要降低存储成本，可以考虑为队列的 Amazon S3 存储桶创建 S3 生命周期配置。有关更多信息，请参阅 *Amazon 简单存储服务用户指南中的管理存储*[生命周期](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html)。

**下载作业、步骤或任务的已完成输出**

1. 按照中的[在 Deadline Cloud 中查看和管理职位详情](view-a-job.md)步骤查看作业列表。

1. 选择要为其下载输出的作业、步骤或任务。
   + 如果选择一个作业，则可以下载该作业所有步骤中所有任务的所有输出。
   + 如果选择某个步骤，则可以下载该步骤中所有任务的所有输出。
   + 如果您选择一项任务，则可以下载该单个任务的输出。

1. 从 “**操作**” 菜单中选择 “**下载输出**”。

1. 输出将下载到提交作业时设置的位置。

**注意**  
目前仅支持Windows和使用菜单下载输出Linux。如果您有Mac并选择了 “**下载输出**” 菜单项，则会出现一个窗口，显示可用于下载渲染输出的 AWS CLI 命令。

# 自动化 Deadline 云端监控桌面部署和工作流程
<a name="monitor-automate-desktop"></a>

De AWS adline Cloud 监控桌面应用程序包括一个命令行界面 (CLI)，管理员可以使用该界面为用户设置配置文件，美工和开发人员可以使用该界面将显示器集成到工作站上的自动工作流程中。

## 查找 Deadline 云监控器可执行
<a name="monitor-automate-desktop-binary-location"></a>

要使用 CLI 命令，请从终端运行 Deadline Cloud 监控器可执行文件。默认安装位置取决于您的操作系统和安装方法。

Windows  

```
%LOCALAPPDATA%\DeadlineCloudMonitor\DeadlineCloudMonitor.exe
```

macOS  

```
/Applications/DeadlineCloudMonitor.app/Contents/MacOS/DeadlineCloudMonitor
```

Linux（deb 或 RPM 软件包）  

```
/usr/bin/deadline-cloud-monitor
```

Linux (AppImage)  
直接从下载 AppImage 文件的地方运行该文件。

在以下示例中，`DeadlineCloudMonitor`替换为操作系统的可执行文件的完整路径。

## 设置配置文件以简化用户访问权限
<a name="monitor-automate-desktop-create-profile"></a>

管理员使用该`create-profile`命令为用户创建 Deadline Cloud 监控配置文件。此命令配置配置文件，以便用户无需进行其他配置或选择配置文件即可打开显示器、登录并开始工作。

该`create-profile`命令接受以下标志：
+ `--enable-auto-login`— 将显示器配置为在应用程序启动时使用最近使用的配置文件自动登录。
+ `--set-as-deadline-default`— 将配置文件设置为 Deadline Cloud 工具的默认配置，包括 Deadline Cloud 提交者、Deadline CLI 和 Deadline Cloud GUI 应用程序。此标志不影响 AWS Command Line Interface (AWS CLI)。

启用这两个标志后，用户将打开显示器并自动登录，无需选择其他配置或配置文件。

**创建配置文件**  


运行以下命令，用显示器详细信息替换占位符值。

```
DeadlineCloudMonitor create-profile \
    --profile profile-name \
    --monitor-id monitor-id \
    --monitor-url https://monitorName.region.deadlinecloud.amazonaws.com \
    --enable-auto-login \
    --set-as-deadline-default
```

该命令创建配置文件并将配置写入用户工作站上的 Deadline Cloud 配置文件中。监视器 URL 的格式必须为`https://monitorName.region.deadlinecloud.amazonaws.com`。

**注意**  
该`create-profile`命令将在创建配置文件后退出。要使用新的配置文件打开显示器，请运行`login`命令或打开 Deadline Cloud 监视器桌面应用程序。

## 将 Deadline Cloud 监视器集成到您的
<a name="monitor-automate-desktop-workflow-integration"></a>

使用`login``logout`、和`handle-url`命令将 Deadline Cloud 监控器集成到工作站上的脚本和自动化工作流程中。

### 登录和注销
<a name="monitor-automate-desktop-login-logout"></a>

使用`login`和`logout`命令控制作为工作流程一部分的身份验证。例如，提交作业的脚本可以使用`login`命令来确保在提交开始之前对用户进行身份验证。

使用该`login`命令时，监视器会直接打开到指定的配置文件，跳过配置文件选择屏幕。身份验证完成后，监视器会最小化到系统托盘，以便您的工作流程可以继续。如果监视器已经在为指定的配置文件运行，则现有窗口将显示在前台而不是启动新实例。

**登录个人资料**  


运行以下命令，替换为 D *profile-name* eadline Cloud 监控配置文件的名称。

```
DeadlineCloudMonitor login --profile profile-name
```

**要注销个人资料**  


运行以下命令以清除配置文件的凭据，并向任何正在运行的监视器实例发出退出该配置文件的信号。

```
DeadlineCloudMonitor logout --profile profile-name
```

### 将显示器打开到特定页面
<a name="monitor-automate-desktop-handle-url"></a>

使用`handle-url`命令将 Deadline Cloud 监视器打开到特定页面。当脚本执行某项操作（例如创建作业），并且您希望自动打开监视器以显示结果时，此命令很有用。例如，在脚本提交作业后，该脚本可以调用，将监视器直接打开`handle-url`到作业详细信息页面。

您还可以使用该 `deadline-cloud-monitor://` URL 作为公司网站、wiki 或任务跟踪器上的链接，让用户直接打开显示器到特定页面。

URL 使用带有`launch`命令的`deadline-cloud-monitor://`协议方案。URL 包括配置文件名称和要打开的监控页面 URL。

**将显示器打开到特定页面**  


运行以下命令，*monitor-page-url*替换为 URL 编码的监控页面 URL 和您的个人资料*profile-name*名称。

```
DeadlineCloudMonitor handle-url --url "deadline-cloud-monitor://launch?url=monitor-page-url&profile=profile-name"
```