Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Introducción a Amazon Kinesis Agent para Microsoft Windows
<a name="getting-started"></a>

Puede utilizar Amazon Kinesis Agent para Microsoft Windows (Kinesis Agent para Windows) para recopilar, analizar, transformar y transmitir registros, eventos y métricas de su flota de Windows a diversos servicios de AWS. La información que se incluye a continuación contiene requisitos previos e instrucciones paso a paso para instalar y configurar Kinesis Agent para Windows.

**Topics**
+ [Prerequisites](#getting-started-prerequisites)
+ [Configuración de una cuenta de AWS](#getting-started-setting-up)
+ [Instalación de Kinesis Agent para Windows](#getting-started-installation)
+ [Configuración e inicio del agente Kinesis para Windows](#getting-started-start-service)

## Prerequisites
<a name="getting-started-prerequisites"></a>

Antes de instalar Kinesis Agent para Windows, asegúrese de que cumple los siguientes requisitos previos:
+ Familiaridad con los conceptos de Kinesis Agent para Windows. Para obtener más información, consulte [Conceptos de Amazon Kinesis Agent para Microsoft Windows](kinesis-agent-windows-concepts.md).
+ Cuenta de AWS para utilizar los distintos servicios de AWS relacionados con la canalización de datos. Para obtener más información sobre la creación y configuración de cuentas de AWS, consulte [Configuración de una cuenta de AWS](#getting-started-setting-up).
+ Microsoft .NET Framework 4.6 o una versión posterior en todos los equipos o servidores que ejecutan Kinesis Agent para Windows. Para obtener más información, consulte [Instalación de .NET Framework para desarrolladores](https://docs.microsoft.com/en-us/dotnet/framework/install/guide-for-developers) en la documentación de Microsoft .NET.

  Para determinar la versión más reciente de.NET Framework que está instalada en un equipo o servidor, utilice el siguiente script de PowerShell:

  ```
       [System.Version](
       (Get-ChildItem 'HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP' -recurse `
       | Get-ItemProperty -Name Version -ErrorAction SilentlyContinue `
       | Where-Object { ($_.PSChildName -match 'Full') } `
       | Select-Object Version | Sort-Object -Property Version -Descending)[0]).Version
  ```
+ Tiene las secuencias con las que desea enviar datos desde Kinesis Agent para Windows (si utiliza Amazon Kinesis Data Streams). Cree las transmisiones utilizando la herramienta[Consola de Kinesis Data Streams](https://console.aws.amazon.com/kinesis/), el[AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html), o bien[Herramientas de AWS para Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/reference/items/New-KINStream.html). Para obtener más información, consulte[Creación y actualización de secuencias de datos](https://docs.aws.amazon.com/streams/latest/dev/amazon-kinesis-streams.html)en la*Guía del desarrollador de Amazon Kinesis Data Streams*.
+ La entrega de Firehose muestra las secuencias con las que desea enviar datos desde Kinesis Agent para Windows (si utiliza Amazon Kinesis Data Firehose). Cree flujos de entrega con la herramienta[Consola Kinesis Data Firehose](https://console.aws.amazon.com/firehose/), el[AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/firehose/create-delivery-stream.html), o bien[Herramientas de AWS para Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/reference/items/New-KINFDeliveryStream.html). Para obtener más información, consulte la sección sobre [creación de una secuencia de entrega de Amazon Kinesis Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) en la *guía para desarrolladores de Amazon Kinesis Data Firehose*.

## Configuración de una cuenta de AWS
<a name="getting-started-setting-up"></a>

Si no dispone de una cuenta de AWS, siga estos pasos para crear una.

**Para inscribirse en una cuenta de AWS**

1. Abra [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup).

1. Siga las instrucciones en línea.

   Parte del procedimiento de inscripción consiste en recibir una llamada telefónica e indicar un código de verificación en el teclado del teléfono.

**Para crearse usted mismo un usuario administrador y agregarlo a un grupo de administradores (consola)**

1. Inicie sesión en la [consola de IAM](https://console.aws.amazon.com/iam/) como propietario de la cuenta seleccionando **Root user (Usuario raíz)** y escribiendo la dirección de correo electrónico de su cuenta de AWS. En la siguiente página, escriba su contraseña.
**nota**  
Le recomendamos que siga la práctica recomendada de utilizar el comando de**Administrator**Usuario de IAM que sigue y bloquea de forma segura las credenciales de usuario raíz. Inicie sesión como usuario raíz únicamente para realizar algunas [tareas de administración de servicios y de cuentas](https://docs.aws.amazon.com/general/latest/gr/aws_tasks-that-require-root.html).

1. En el panel de navegación, elija **Users (Usuarios)** y, a continuación, elija **Add user (Añadir usuario)**.

1. En **User name (Nombre de usuario)**, escriba **Administrator**.

1. Active la casilla de verificación situada junto al **AWS Management Console access (Acceso a la consola de administración de AWS)**. A continuación, seleccione **Custom password (Contraseña personalizada)** y luego escriba la nueva contraseña en el cuadro de texto.

1. (Opcional) De forma predeterminada, AWS requiere que el nuevo usuario cree una nueva contraseña la primera vez que inicia sesión. Puede quitar la marca de selección de la casilla de verificación situada junto a **User must create a new password at next sign-in (El usuario debe crear una nueva contraseña en el siguiente inicio de sesión)** para permitir al nuevo usuario restablecer su contraseña después de iniciar sesión.

1. Seleccionar**Siguiente: Permisos.**

1. En **Set permissions (Establecer persmisos)**, elija **Add user to group (Añadir usuario a grupo)**.

1. Elija **Create group (Crear grupo)**.

1. En el cuadro de diálogo **Create group (Crear grupo)**, en **Group name (Nombre del grupo)** escriba **Administrators**.

1. Seleccionar**Políticas de filtrado**Y, a continuación, seleccione**AWS administrado - función de trabajo**para filtrar el contenido de la tabla.

1. En la lista de políticas, active la casilla de verificación **AdministratorAccess**. A continuación, elija **Create group (Crear grupo)**.
**nota**  
Debe activar el acceso de usuario y rol de IAM a Facturación antes de poder utilizar los permisos `AdministratorAccess` para acceder a la consola de AWS Billing and Cost Management. Para ello, siga las instrucciones que se indican en el [paso 1 del tutorial sobre cómo delegar el acceso a la consola de facturación](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_billing.html).

1. Retroceda a la lista de grupos y active la casilla de verificación del nuevo grupo. Elija **Refresh** si es necesario para ver el grupo en la lista.

1. Seleccionar**Siguiente: Tags (Etiquetas):**.

1. (Opcional) Añadir metadatos al rol asociando las etiquetas como pares de clave-valor. Para obtener más información sobre el uso de etiquetas en IAM, consulte [Etiquetado de entidades de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) en la *guía del usuario de IAM*.

1. Seleccionar**Siguiente: Review (Revisar)**Para ver la lista de suscripciones a grupos que se van a añadir al nuevo usuario. Cuando esté listo para continuar, elija **Create user (Crear usuario)**.

Puede usar este mismo proceso para crear más grupos y usuarios, y para conceder a los usuarios acceso los recursos de su cuenta de AWS. Para obtener información sobre cómo usar las políticas que restringen los permisos de los usuarios a recursos de AWS específicos, consulte [Administración de acceso](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) y [Políticas de ejemplo](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_examples.html).

**Para registrarse en AWS y crear una cuenta de administrador**

1. Si no tiene una cuenta de AWS, consulte[https://aws.amazon.com/](https://aws.amazon.com/). Elija **Cree una cuenta de AWS** y siga las instrucciones online.

   Parte del procedimiento de inscripción consiste en recibir una llamada telefónica e introducir un número PIN con el teclado del teléfono.

1. Inicie sesión en la consola de administración de AWS y abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. En el panel de navegación, elija **Groups (Grupos)** y, a continuación, elija **Create New Group (Crear nuevo grupo)**.

1. En **Group Name (Nombre de grupo)**, escriba el nombre del grupo, como **Administrators**, y seleccione **Next Step (Paso siguiente)**.

1. En la lista de políticas, seleccione la casilla de verificación situada junto a la política **AdministratorAccess**. Puede utilizar el menú de **Filter (filtros)** y el cuadro de **Search (búsqueda)** para filtrar la lista de políticas.

1. Elija **Next Step (Paso siguiente)**. Seleccione **Create Group (Crear grupo)**. El nuevo grupo aparecerá debajo de **Group Name (Nombre de grupo)**.

1. En el panel de navegación, seleccione **Users** y después **Create New Users**.

1. En el cuadro **1**, escriba un nombre de usuario, desactive la casilla situada junto a **Generate an access key for each user (Generar una clave de acceso para cada usuario)** y seleccione **Create (Crear)**.

1. En la lista de usuarios, elija el nombre (no la casilla) del usuario que acaba de crear. Puede utilizar el cuadro **Search (Buscar)** para buscar el nombre de usuario.

1. Seleccione la pestaña **Groups (Grupos)** y haga clic en **Add User to Groups (Añadir usuario a grupos)**.

1. Active la casilla situada junto al grupo de administradores y seleccione **Add to Groups (Añadir a grupos)**.

1. Elija la pestaña **Security credentials (Credenciales de seguridad)**. En **Sign-In Credentials (Credenciales de inicio de sesión)**, elija **Manage Password (Administrar contraseña)**.

1. Seleccione **Assign a custom password (Asignar una contraseña personalizada)**, especifique una contraseña en los cuadros **Password (Contraseña)** y **Confirm Password (Confirmar contraseña)** y haga clic en **Apply (Aplicar)**.

## Instalación de Kinesis Agent para Windows
<a name="getting-started-installation"></a>

Hay tres formas de instalar Kinesis Agent para Windows:
+ Instale con MSI (un paquete de instalación de Windows).
+ Instalar desde[AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/), un conjunto de servicios para la administración de servidores y equipos de escritorio.
+ Ejecutar un script de PowerShell.

**nota**  
En las siguientes instrucciones, se utilizan de forma ocasional los términos *KinesisTap* y *AWSKinesisTap*. Estas palabras significan lo mismo que Kinesis Agent para Windows, pero debe especificarlas tal y como están cuando ejecute estas instrucciones.

### Instalar Kinesis Agent para Windows con MSI
<a name="install-msi"></a>

Puede descargar el paquete MSI de Kinesis Agent para Windows desde la[repositorio kinesis-agent-windows en GitHub](https://github.com/awslabs/kinesis-agent-windows/releases). Después de descargar el MSI, use Windows para iniciarlo y siga las instrucciones del instalador. Después de la instalación, puede desinstalar como lo haría con cualquier aplicación de Windows.

También puede utilizar la herramienta de comando[msiexec](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec)En el símbolo del sistema de Windows para instalar de forma silenciosa, activar el registro y desinstalar tal y como se muestra en los siguientes ejemplos. Reemplazar`AWSKinesisTap.1.1.216.4.msi with the appropriate version of Kinesis Agent for Windows for your application.`

**Para instalar Kinesis Agent para Windows de forma silenciosa:**

```
msiexec /i AWSKinesisTap.1.1.216.4.msi /q
```

**Para registrar mensajes de instalación para solucionar problemas en un archivo llamado`logfile.log`:**

```
msiexec /i AWSKinesisTap.1.1.216.4.msi /q /L*V logfile.log
```

**Para desinstalar Kinesis Agent para Windows mediante el símbolo del sistema:**

```
msiexec.exe /x {ADAB3982-68AA-4B45-AE09-7B9C03F3EBD3} /q
```

### Instalar Kinesis Agent para Windows mediante AWS Systems Manager
<a name="install-systems-manager"></a>

Siga estos pasos para instalar Kinesis Agent para Windows mediante el comando de ejecución de Systems Manager Run Command. Para obtener más información acerca de Run Command, consulte[AWS Systems Manager Run Command](https://docs.aws.amazon.com/systems-manager/latest/userguide/execute-remote-commands.html)en la*Guía del usuario de AWS Systems Manager*. Además de utilizar Systems Manager Run Command, también puede utilizar Systems Manager[Períodos de mantenimiento](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-maintenance.html)y[State Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-state.html)para automatizar la implementación de Kinesis Agent para Windows a lo largo del tiempo.

**nota**  
La instalación de Systems Manager para Kinesis Agent para Windows está disponible en las regiones de AWS que se indican en la lista de AWS[AWS Systems Manager](https://docs.aws.amazon.com/general/latest/gr/rande.html#ssm_region)excepto las siguientes:  
cn-north-1
cn-northwest-1
Todas las regiones de AWS GovCloud.

**Para instalar Kinesis Agent para Windows mediante el Systems Manager**

1. Asegúrese de que la versión 2.2.58.0 o posterior del agente de SSM de está instalada en las instancias en las que desea instalar Kinesis Agent para Windows. Para obtener más información, consulte[Instalación y configuración del agente de SSM en instancias de Windows](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html)en la*Guía del usuario de AWS Systems Manager*.

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

1. En el panel de navegación, en la sección de**Administración de nodos**, elija**Run Command**Y luego seleccione**Run Command**.

1. Desde la**Documento de comandos**, seleccione la casilla**AWS-ConfigureAWSPackage**no válido.  
![\[Seleccione el documento AWS-ConfigureAWSPackage de.\]](http://docs.aws.amazon.com/es_es/kinesis-agent-windows/latest/userguide/images/runcommand-document-select.png)

1. UNDER**Parámetros de comando**, para**Nombre**, escriba**AWSKINISTAP**. Deje otras opciones con sus valores predeterminados.
**nota**  
Deje**Version**Para especificar la última versión del paquete AWSKinesistap. Si lo desea, también puede introducir una versión específica para instalar.  
![\[Especifique el paquete awskinesistap en los parámetros Command.\]](http://docs.aws.amazon.com/es_es/kinesis-agent-windows/latest/userguide/images/runcommand-specify-options.png)

1. UNDER**implementación**, especifique las instancias en las que desea ejecutar el comando. Puede elegir especificar instancias basadas en etiquetas asociadas a instancias, puede elegir instancias manualmente o puede especificar un grupo de recursos que incluya instancias.

1. Deje el resto de opciones con sus valores predeterminados y seleccione**Ejecución de**.

### Instalar el agente Kinesis para Windows mediante PowerShell
<a name="install-ps"></a>

Utilice un editor de texto para copiar los siguientes comandos en un archivo y guardarlo como un script de PowerShell. Utilizamos`InstallKinesisAgent.ps1`En el siguiente ejemplo.

```
Param(
    [ValidateSet("prod", "beta", "test")]
    [string] $environment = 'prod',
    [string] $version,
    [string] $baseurl
)

# Self-elevate the script if required.
if (-Not ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] 'Administrator')) {
    if ([int](Get-CimInstance -Class Win32_OperatingSystem | Select-Object -ExpandProperty BuildNumber) -ge 6000) {
        $CommandLine = '-File "' + $MyInvocation.MyCommand.Path + '" ' + $MyInvocation.UnboundArguments
        Start-Process -FilePath PowerShell.exe -Verb Runas -ArgumentList $CommandLine
        Exit
    }
}

# Allows input to change base url. Useful for testing.
if ($baseurl) {
    if (!$baseUrl.EndsWith("/")) {
        throw "Invalid baseurl param value. Must end with a trailing forward slash ('/')"
    }

    $kinesistapBaseUrl = $baseurl
} else {
    $kinesistapBaseUrl = "https://s3-us-west-2.amazonaws.com/kinesis-agent-windows/downloads/"
}

Write-Host "Using $kinesistapBaseUrl as base url"

$webClient = New-Object System.Net.WebClient

try {
    $packageJson = $webClient.DownloadString($kinesistapBaseUrl + 'packages.json' + '?_t=' + [System.DateTime]::Now.Ticks) | ConvertFrom-Json
} catch {
    throw "Downloading package list failed."
}


if ($version) {
    $kinesistapPackage = $packageJson.packages | Where-Object { $_.packageName -eq "AWSKinesisTap.$version.nupkg" }

    if ($null -eq $kinesistapPackage) {
        throw "No package found matching input version $version"
    }
} else {
    $packageJson = $packageJson.packages | Where-Object { $_.packageName -match ".nupkg" }
    $kinesistapPackage = $packageJson[0]
}

$packageName = $kinesistapPackage.packageName
$checksum = $kinesistapPackage.checksum

#Create %TEMP%/kinesistap if not exists
$kinesistapTempDir = Join-Path $env:TEMP 'kinesistap'
if (![System.IO.Directory]::Exists($kinesistapTempDir)) {[void][System.IO.Directory]::CreateDirectory($kinesistapTempDir)}

#Download KinesisTap.x.x.x.x.nupkg package
$kinesistapNupkgPath = Join-Path $kinesistapTempDir $packageName
$webClient.DownloadFile($kinesistapBaseUrl + $packageName, $kinesistapNupkgPath)
$kinesistapUnzipPath = $kinesistapNupkgPath.Replace('.nupkg', '')

# Calculates hash of downloaded file. Downlevel compatible using .Net hashing on PS < 4
if ($PSVersionTable.PSVersion.Major -ge 4) {
    $calculatedHash = Get-FileHash $kinesistapNupkgPath -Algorithm SHA256
    $hashAsString = $calculatedHash.Hash.ToLower()
} else {
    $sha256 = New-Object System.Security.Cryptography.SHA256CryptoServiceProvider
    $calculatedHash = [System.BitConverter]::ToString($sha256.ComputeHash([System.IO.File]::ReadAllBytes($kinesistapNupkgPath)))
    $hashAsString = $calculatedHash.Replace("-", "").ToLower()
}

if ($checksum -eq $hashAsString) {
	Write-Host 'Local file hash matches checksum.' -ForegroundColor Green
} else {
	throw ("Get-FileHash does not match! Package may be corrupted.")
}

#Delete Unzip path if not empty
if ([System.IO.Directory]::Exists($kinesistapUnzipPath)) {Remove-Item –Path $kinesistapUnzipPath -Recurse -Force}

#Unzip KinesisTap.x.x.x.x.nupkg package
$null = [System.Reflection.Assembly]::LoadWithPartialName('System.IO.Compression.FileSystem')
[System.IO.Compression.ZipFile]::ExtractToDirectory($kinesistapNupkgPath, $kinesistapUnzipPath)

#Execute chocolaeyInstall.ps1 in the package and wait for completion.
$installScript = Join-Path $kinesistapUnzipPath '\tools\chocolateyInstall.ps1'
& $installScript

# Verify service installed.
$serviceName = 'AWSKinesisTap'
$service = Get-Service -Name $serviceName -ErrorAction Ignore
if ($null -eq $service) {
    throw ("Service not installed correctly.")
} else {
    Write-Host "Kinesis Tap Installed." -ForegroundColor Green
    Write-Host "After configuring run the following to start the service: Start-Service -Name $serviceName." -ForegroundColor Green
}
```

Abra una ventana del símbolo del sistema con permisos elevados. En el directorio en el que descargó el archivo, utilice el comando siguiente para ejecutar el script:

```
PowerShell.exe -File ".\InstallKinesisAgent.ps1"
```

Para instalar una versión específica de Kinesis Agent para Windows, agregue el comando`-version`Opción:

```
PowerShell.exe -File ".\InstallKinesisAgent.ps1" -version "version"
```

Reemplazar*version*con un número de versión válido de Kinesis Agent para Windows. Para obtener información sobre la versión, consulte la[repositorio kinesis-agent-windows en GitHub](https://github.com/awslabs/kinesis-agent-windows/blob/master/README.md).

Existen muchas herramientas de implementación que pueden ejecutar scripts de PowerShell de forma remota. Pueden utilizarse para automatizar la instalación de Kinesis Agent para Windows en flotas de equipos de escritorio o servidores.

## Configuración e inicio del agente Kinesis para Windows
<a name="getting-started-start-service"></a>

Después de instalar Kinesis Agent para Windows, debe configurar e iniciar el agente. Una vez hecho esto, no será necesario realizar ninguna otra operación.

**Para configurar e iniciar Kinesis Agent para Windows**

1. Cree e implemente un archivo de configuración de Kinesis Agent para Windows. Este archivo configura los orígenes, los receptores y las canalizaciones, junto con otros elementos de configuración globales. 

   Para obtener más información acerca de la configuración de Kinesis Agent para Windows, consulte[Configuración de Amazon Kinesis Agent para Microsoft Windows](configuring-kinesis-agent-windows.md).

   Para completar ejemplos de archivos de configuración que puede personalizar e instalar, consulte [Ejemplos de configuración de Kinesis Agent para Windows](configuring-kaw-examples.md).

1. Abra una ventana de símbolo del sistema de PowerShell con privilegios elevados e inicie Kinesis Agent para Windows con el siguiente comando de PowerShell:

   ```
   Start-Service -Name AWSKinesisTap
   ```