# Inicio del agente de CloudWatch
<a name="start-CloudWatch-Agent-on-premise-SSM-onprem"></a>

Se puede iniciar el agente de CloudWatch mediante Run Command de Systems Manager o con la línea de comandos.

Para obtener información sobre la configuración del agente en un sistema que tenga habilitado Linux con seguridad mejorada (SELinux), consulte [Configuración del agente de CloudWatch con Linux con seguridad mejorada (SELinux)](CloudWatch-Agent-SELinux.md).

## Iniciar el agente de CloudWatch mediante la línea de comandos en Amazon EC2
<a name="start-CloudWatch-Agent-EC2-commands-fleet"></a>

Haga esto para utilizar la línea de comandos para iniciar el agente de CloudWatch en Amazon EC2.

Para obtener información sobre la configuración del agente en un sistema que tenga habilitado Linux con seguridad mejorada (SELinux), consulte [Configuración del agente de CloudWatch con Linux con seguridad mejorada (SELinux)](CloudWatch-Agent-SELinux.md).

**Para utilizar la línea de comandos para iniciar el agente de CloudWatch en Amazon EC2**

1. Copie el archivo de configuración del agente que desea utilizar en el servidor donde va a ejecutar el agente. Anote el nombre de la ruta donde lo va a copiar.

1. En este comando, `-a fetch-config` provoca que el agente cargue la última versión del archivo de configuración del agente de CloudWatch y `-s` inicia el agente.

   Especifique uno de los siguientes comandos. Reemplace {{configuration-file-path}} por la ruta al archivo de configuración del agente. Este archivo se denomina `config.json` si lo creó con el asistente y podría llamarse `amazon-cloudwatch-agent.json` si lo creó manualmente.

   En una instancia EC2 que ejecute Linux, escriba el siguiente comando. 

   ```
   sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -s -c file:{{configuration-file-path}}
   ```

   En un servidor local que ejecute Linux, escriba lo siguiente:

   ```
   sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m onPremise -s -c file:{{configuration-file-path}}
   ```

   En una instancia EC2 que ejecute Windows Server, escriba lo siguiente desde la consola de PowerShell:

   ```
   & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m ec2 -s -c file:{{configuration-file-path}}
   ```

   En un servidor local que ejecute Windows Server, escriba lo siguiente desde la consola de PowerShell:

   ```
   & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m onPremise -s -c file:{{configuration-file-path}}
   ```

## Iniciar el agente de CloudWatch en un servidor en las instalaciones
<a name="start-CloudWatch-Agent-on-premises"></a>

Haga lo siguiente para iniciar el agente de CloudWatch en un servidor en las instalaciones.

**Para utilizar SSM Agent con el fin de iniciar el agente de CloudWatch en un servidor en las instalaciones**

1. Abra la consola de Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. En el panel de navegación, elija **Ejecutar comando**.

   -o bien-

   Si la página de inicio de AWS Systems Manager se abre, desplácese hacia abajo y elija **Explore Run Command** (Explorar Run Command).

1. Elija **Run command (Ejecutar comando)**.

1. En la lista **Command document**, seleccione el botón situado junto a **AmazonCloudWatch-ManageAgent**.

1. En el área **Targets**, seleccione la instancia donde ha instalado el agente.

1. En la lista **Action**, elija **configure**.

1. En la lista **Mode**, elija **onPremise**.

1. En el cuadro **Ubicación de configuración opcional**, ingrese el nombre del archivo de configuración del agente que ha creado con el asistente y que ha guardado en el almacén de parámetros.

1. Seleccione **Ejecutar**.

   El agente se inicia con la configuración que ha especificado en el archivo de configuración.

**Para utilizar la línea de comandos con el fin de iniciar el agente de CloudWatch en un servidor en las instalaciones**
+ En este comando, `-a fetch-config` provoca que el agente cargue la última versión del archivo de configuración del agente de CloudWatch y `-s` inicia el agente.

  Linux: si ha guardado el archivo de configuración en el almacén de parámetros de Systems Manager, ingrese lo siguiente:

  ```
  sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m onPremise -s -c ssm:{{configuration-parameter-store-name}}
  ```

  Linux: si ha guardado el archivo de configuración en el equipo local, escriba el siguiente comando: Reemplace {{configuration-file-path}} por la ruta al archivo de configuración del agente. Este archivo se denomina `config.json` si lo creó con el asistente y podría llamarse `amazon-cloudwatch-agent.json` si lo creó manualmente.

  ```
  sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m onPremise -s -c file:{{configuration-file-path}}
  ```

  Windows Server: si ha guardado el archivo de configuración del agente en el almacén de parámetros de Systems Manager, ingrese lo siguiente en la consola de PowerShell:

  ```
  & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m onPremise -s -c ssm:{{configuration-parameter-store-name}}
  ```

  Windows Server: si ha guardado el archivo de configuración del agente en el equipo local, escriba lo siguiente en la consola de PowerShell. Reemplace {{configuration-file-path}} por la ruta al archivo de configuración del agente. Este archivo se denomina `config.json` si lo creó con el asistente y podría llamarse `amazon-cloudwatch-agent.json` si lo creó manualmente.

  ```
  & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m onPremise -s -c file:{{configuration-file-path}}
  ```