

# Secciones de configuración del componente
<a name="component-config-sections"></a>

La configuración de un componente incluye varias secciones principales. Las secciones de la configuración de un componente pueden estar en cualquier orden.
+ **alarmMetrics (opcional)**

  Una lista de [métricas](#component-config-metric) que se van a monitorizar para el componente. Todos los tipos de componente pueden tener una sección alarmMetrics. 
+ **logs (opcional)**

  Una lista de [registros](#component-configuration-log) que se van a monitorizar para el componente. Solo las instancias EC2 pueden tener una sección de registros. 
+ **procesos (opcional)**

  Una lista de [procesos](#component-configuration-process) a monitorizar para el componente. Solo las instancias EC2 pueden tener una sección de procesos. 
+ **subComponents (opcional)**

  Configuración de la instancia anidada y subcomponente de volumen para el componente. Los siguientes tipos de componente pueden tener instancias anidadas y una sección de subcomponentes: ELB, ASG, instancias EC2 agrupadas de manera personalizada e instancias EC2.
+ **alarms (opcional)**

  Una lista de [alarmas](#component-configuration-alarms) que se van a monitorizar para el componente. Todos los tipos de componente pueden tener una sección alarm.
+ **windowsEvents (opcional)**

  Una lista de [windows events](#windows-events) (eventos de Windows) para monitorear el componente. Solo Windows en instancias EC2 tienen una sección `windowsEvents`.
+ **JMXPrometheusExporter (opcional)**

  Configuración de JMXPrometheus Exporter
+ **HanaprometheusExporter (opcional)**

  Configuración de SAP HANA Prometheus Exporter (Exportador SAP Hana para Prometheus).
+ **haClusterPrometheusExporter (opcional)**

  Configuración de HA Cluster Prometheus Exporter (Exportador de clúster de alta disponibilidad para Prometheus).
+ **netWeaverPrometheusExporter (opcional) **

  Configuración del exportador de Prometheus de SAP NetWeaver
+ **sapAsePrometheusExporter (opcional)**

  Configuración de SAP ASE Prometheus Exporter.

En el siguiente ejemplo se muestra la sintaxis para el **fragmento de la sección de subcomponentes** en formato JSON.

```
[
  {
    "subComponentType" : "AWS::EC2::Instance",
    "alarmMetrics" : [
      list of alarm metrics
    ],
    "logs" : [
      list of logs
    ],
    "processes": [
      list of processes
    ],
    "windowsEvents" : [
      list of windows events channels configurations
    ]
  },
  {
    "subComponentType" : "AWS::EC2::Volume",
    "alarmMetrics" : [
      list of alarm metrics
    ]
  }
]
```

## Propiedades de la sección de configuración del componente
<a name="component-config-properties"></a>

En esta sección se describen las propiedades de cada sección de configuración de componentes.

**Topics**
+ [Métrica](#component-config-metric)
+ [Registro](#component-configuration-log)
+ [Proceso](#component-configuration-process)
+ [JMX Prometheus Exporter](#component-configuration-prometheus)
+ [HANA Prometheus Exporter (Exportador HANA para Prometheus)](#component-configuration-hana-prometheus)
+ [HA Cluster Prometheus Exporter (Exportador de clúster de alta disponibilidad para Prometheus)](#component-configuration-ha-cluster-prometheus)
+ [Exportador de Prometheus de NetWeaver](#component-configuration-netweaver-prometheus)
+ [SAP ASE Prometheus Exporter](#component-configuration-sap-ase-prometheus)
+ [Eventos de Windows](#windows-events)
+ [Alarma](#component-configuration-alarms)

### Métrica
<a name="component-config-metric"></a>

Define una métrica que se va a monitorizar para el componente.

**JSON** 

```
{
  "alarmMetricName" : "monitoredMetricName",
  "monitor" : true/false
}
```

**Propiedades de**
+ **alarmMetricName (obligatorio)**

  El nombre de la métrica que se va a monitorizar para el componente. Para conocer las métricas admitidas por Información de aplicaciones, consulte [Registros y métricas que Información de aplicaciones de Amazon CloudWatch admite](appinsights-logs-and-metrics.md). 
+ **monitor (opcional)**

  Valor booleano para indicar si se debe monitorizar la métrica. El valor predeterminado es `true`.

### Registro
<a name="component-configuration-log"></a>

Define un registro que se va a monitorizar para el componente.

**JSON** 

```
{
  "logGroupName" : "logGroupName",
  "logPath" : "logPath",
  "logType" : "logType",
  "encoding" : "encodingType",
  "monitor" : true/false
}
```

**Propiedades de**
+ **logGroupName (obligatorio)**

  El nombre del grupo de registros de CloudWatch que se asociará al registro monitorizado. Para conocer las restricciones de nombre del grupo de registros, consulte [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html).
+ **logPath (obligatorio para los componentes de la instancia EC2 y no para los componentes que no usan un agente de CloudWatch, como AWS Lambda)**

  La ruta de los registros que se van a monitorizar. La ruta de los registros debe ser una ruta absoluta de archivos del sistema de Windows. Para obtener más información, consulte [Archivo de configuración del agente de CloudWatch: sección de registros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html#CloudWatch-Agent-Configuration-File-Logssection). 
+ **logType (obligatorio)**

  El tipo de registro decide los patrones de registro con respecto a los cuales Información de aplicaciones analiza el registro. El tipo de registro se selecciona entre las siguientes opciones:
  + `SQL_SERVER`
  + `MYSQL`
  + `MYSQL_SLOW_QUERY`
  + `POSTGRESQL`
  + `ORACLE_ALERT`
  + `ORACLE_LISTENER`
  + `IIS`
  + `APPLICATION`
  + `WINDOWS_EVENTS`
  + `WINDOWS_EVENTS_ACTIVE_DIRECTORY`
  + `WINDOWS_EVENTS_DNS`
  + `WINDOWS_EVENTS_IIS`
  + `WINDOWS_EVENTS_SHAREPOINT`
  + `SQL_SERVER_ALWAYSON_AVAILABILITY_GROUP`
  + `SQL_SERVER_FAILOVER_CLUSTER_INSTANCE`
  + `DEFAULT`
  + `CUSTOM`
  + `STEP_FUNCTION`
  + `API_GATEWAY_ACCESS`
  + `API_GATEWAY_EXECUTION`
  + `SAP_HANA_LOGS`
  + `SAP_HANA_TRACE`
  + `SAP_HANA_HIGH_AVAILABILITY`
  + `SAP_NETWEAVER_DEV_TRACE_LOGS`
  + `PACEMAKER_HIGH_AVAILABILITY`
+ **encoding (opcional)**

  El tipo de codificación de los registros que se van a monitorizar. La codificación especificada debe incluirse en la lista de [codificaciones compatibles con el agente de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AgentReference.html). Si no se proporciona, Información de aplicaciones de CloudWatch utiliza el tipo de codificación predeterminado utf-8, excepto para: 
  +  `SQL_SERVER`: codificación utf-16
  +  `IIS`: codificación ascii
+ **monitor (opcional)**

  Valor booleano que indica si se deben monitorizar los registros. El valor predeterminado es `true`.

### Proceso
<a name="component-configuration-process"></a>

Define un proceso que se va a monitorizar para el componente.

**JSON** 

```
{
  "processName" : "monitoredProcessName",
  "alarmMetrics" : [
      list of alarm metrics
  ] 
}
```

**Propiedades de**
+ **processName (obligatorio)**

  El nombre del proceso a monitorizar para el componente. El nombre del proceso no debe contener una raíz de proceso, como `sqlservr` o `sqlservr.exe`.
+ **alarmMetrics (obligatorio)**

  Una lista de [métricas](#component-config-metric) a supervisar para este proceso. Para ver las métricas de procesos admitidas por Información de aplicaciones de CloudWatch, consulte [Amazon Elastic Compute Cloud (EC2)](appinsights-metrics-ec2.md).

### JMX Prometheus Exporter
<a name="component-configuration-prometheus"></a>

Define la configuración de JMX Prometheus Exporter.

**JSON** 

```
"JMXPrometheusExporter": {
  "jmxURL" : "JMX URL",
  "hostPort" : "The host and port",
  "prometheusPort" : "Target port to emit Prometheus metrics"
}
```

**Propiedades de**
+ **jmxURL (opcional)**

  Una URL completa de JMX a la que conectarse.
+ **hostPort (opcional)**

  El host y el puerto al que se conectarán a través de JMX remoto. Solo puede especificarse uno de `jmxURL` y `hostPort`.
+ **prometheusPort (opcional)**

  El puerto de destino al que enviarán las métricas de Prometheus. Si no se especifica, se utiliza el puerto predeterminado 9404.

### HANA Prometheus Exporter (Exportador HANA para Prometheus)
<a name="component-configuration-hana-prometheus"></a>

Define la configuración de HANA Prometheus Exporter.

**JSON** 

```
"hanaPrometheusExporter": {
    "hanaSid": "SAP HANA  SID",
    "hanaPort": "HANA database port",
    "hanaSecretName": "HANA secret name",
    "prometheusPort": "Target port to emit Prometheus metrics"
}
```

**Propiedades de**
+ **hanaSid**

  ID de sistema SAP (SID) de tres caracteres del sistema SAP HANA.
+ **hanaPort**

  El puerto de base de datos HANA mediante el cual el exportador consultará las métricas de HANA.
+ **hanaSecretName**

  El AWS Secrets Manager secreto que almacena las credenciales de usuario de monitoreo de HANA. En el exportador HANA de Prometheus se utilizan estas credenciales para conectarse a la base de datos y consultar métricas de HANA.
+ **prometheusPort (opcional)**

  El puerto de destino al que se enviarán las métricas de Prometheus. Si no se especifica, se utiliza el puerto predeterminado 9668.

### HA Cluster Prometheus Exporter (Exportador de clúster de alta disponibilidad para Prometheus)
<a name="component-configuration-ha-cluster-prometheus"></a>

Define la configuración de HA Cluster Prometheus Exporter (Exportador de clúster de alta disponibilidad para Prometheus).

**JSON** 

```
"haClusterPrometheusExporter": {
    "prometheusPort": "Target port to emit Prometheus metrics"
}
```

**Propiedades de**
+ **prometheusPort (opcional)**

  El puerto de destino al que se enviarán las métricas de Prometheus. Si no se especifica, se utiliza el puerto predeterminado 9664.

### Exportador de Prometheus de NetWeaver
<a name="component-configuration-netweaver-prometheus"></a>

Permite definir la configuración del exportador de Prometheus de NetWeaver.

**JSON** 

```
"netWeaverPrometheusExporter": {
    "sapSid": "SAP NetWeaver  SID",
    "instanceNumbers": [ "Array of instance Numbers of SAP NetWeaver system "],
"prometheusPort": "Target port to emit Prometheus metrics"
}
```

**Propiedades de**
+ **sapSid**

  ID de sistema SAP (SID) de tres caracteres del sistema SAP NetWeaver.
+ **instanceNumbers**

  Matriz de números de instancia del sistema SAP NetWeaver.

  **Ejemplo de: **`"instanceNumbers": [ "00", "01"]`
+ **prometheusPort (opcional)**

  El puerto de destino al que se enviarán las métricas de Prometheus. Si no se especifica, se utiliza el puerto predeterminado `9680`.

### SAP ASE Prometheus Exporter
<a name="component-configuration-sap-ase-prometheus"></a>

Define la configuración de SAP ASE Prometheus Exporter.

**JSON** 

```
"sapASEPrometheusExporter": {
    "sapAseSid": "SAP ASE SID",
    "sapAsePort": "SAP ASE database port",
    "sapAseSecretName": "SAP ASE secret name",
    "prometheusPort": "Target port to emit Prometheus metrics",
    "agreeToEnableASEMonitoring": true
}
```

**Propiedades de**
+ **sapAseSid**

  Identificador del sistema SAP (SID) de tres caracteres del sistema SAP ASE.
+ **sapAsePort**

  El puerto de base de datos de SAP ASE mediante el cual el exportador consultará las métricas de ASE.
+ **sapAseSecretName**

  El AWS Secrets Manager secreto que almacena las credenciales de usuario de supervisión de ASE. En SAP ASE Prometheus Exporter se utilizan estas credenciales para conectarse a la base de datos y consultar métricas de ASE.
+ **prometheusPort (opcional)**

  El puerto de destino al que se enviarán las métricas de Prometheus. Si no se especifica, se utiliza el puerto predeterminado 9399. Si hay otra base de datos ASE que utilice el puerto predeterminado, entonces usaremos el 9499.

### Eventos de Windows
<a name="windows-events"></a>

Define los eventos de Windows que se van a registrar.

**JSON** 

```
{
  "logGroupName" : "logGroupName",
  "eventName" : "eventName",
  "eventLevels" : ["ERROR","WARNING","CRITICAL","INFORMATION","VERBOSE"],
  "monitor" : true/false
}
```

**Propiedades de**
+ **logGroupName (obligatorio)**

  El nombre del grupo de registros de CloudWatch que se asociará al registro monitorizado. Para conocer las restricciones de nombre del grupo de registros, consulte [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html).
+ **eventName (obligatorio)**

  El tipo de eventos de Windows que se van a registrar. Equivale al nombre del canal del registro de eventos de Windows. Por ejemplo, System, Security, CustomEventName, etc. Este campo es obligatorio para cada tipo de evento de Windows que se registrará. 
+ **eventLevels (obligatorio)**

  Los niveles de evento que registrar. Debe especificar cada nivel que se registrará. Entre los valores posibles se incluyen `INFORMATION`, `WARNING`, `ERROR`, `CRITICAL` y `VERBOSE`. Este campo es obligatorio para cada tipo de evento de Windows que se registrará.
+ **monitor (opcional)**

  Valor booleano que indica si se deben monitorizar los registros. El valor predeterminado es `true`.

### Alarma
<a name="component-configuration-alarms"></a>

Define una alarma de CloudWatch que se va a monitorizar para el componente.

**JSON** 

```
{
  "alarmName" : "monitoredAlarmName",
  "severity" : HIGH/MEDIUM/LOW
}
```

**Propiedades de**
+ **alarmName (obligatorio)**

  El nombre de la alarma de CloudWatch que se va a monitorizar para el componente.
+ **severity (opcional)**

  Indica el grado de interrupción al sonar la alarma. 