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

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.

Prerequisites

Antes de instalar Kinesis Agent para Windows, asegúrese de que cumple los siguientes requisitos previos:

Configuración de una cuenta de AWS

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

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 y Políticas de ejemplo.

Instalación de Kinesis Agent para Windows

Hay tres formas de instalar Kinesis Agent para Windows:

Instalar Kinesis Agent para Windows con MSI

Puede descargar el paquete MSI de Kinesis Agent para Windows desde larepositorio kinesis-agent-windows en GitHub. 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 comandomsiexecEn 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. ReemplazarAWSKinesisTap.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 llamadologfile.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

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, consulteAWS Systems Manager Run Commanden laGuía del usuario de AWS Systems Manager. Además de utilizar Systems Manager Run Command, también puede utilizar Systems ManagerPeríodos de mantenimientoyState Managerpara automatizar la implementación de Kinesis Agent para Windows a lo largo del tiempo.

Instalar el agente Kinesis para Windows mediante PowerShell

Utilice un editor de texto para copiar los siguientes comandos en un archivo y guardarlo como un script de PowerShell. UtilizamosInstallKinesisAgent.ps1En 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-versionOpción:

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

Reemplazarversioncon un número de versión válido de Kinesis Agent para Windows. Para obtener información sobre la versión, consulte larepositorio kinesis-agent-windows en GitHub.

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

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.