Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Démarrez avec l'agent Amazon Kinesis

Vous pouvez utiliser Amazon Kinesis Agent for Microsoft Windows (Kinesis Agent for Windows) pour collecter, analyser, transformer et diffuser des journaux, événements et métriques de votre flotte Windows et les diffuser vers différents services AWS. Les informations suivantes contiennent des prérequis et les instructions étape par étape pour installer et configurer Kinesis Agent pour Windows.

Prerequisites

Avant d'installer Kinesis Agent pour Windows, veillez à disposer des prérequis suivants :

Configuration d'un compte AWS

Si vous n'avez pas de compte AWS, complétez les étapes suivantes pour en créer un.

Vous pouvez utiliser ce même processus pour créer d'autres groupes et utilisateurs et pour accorder l'accès aux ressources de votre compte AWS à vos utilisateurs. Pour en savoir plus sur l'utilisation des stratégies permettant de limiter les autorisations d'accès des utilisateurs à certaines ressources AWS, veuillez consulter Gestion des accès et Exemples de stratégies.

Installation de Kinesis Agent pour Windows

Vous pouvez installer Kinesis Agent pour Windows sous Windows trois façons :

Installer Kinesis Agent pour Windows à l'aide de MSI

Vous pouvez télécharger le dernier package Kinesis Agent pour Windows MSI à partir duréférentiel kinesis-agent-windows sur GitHub. Après avoir téléchargé le MSI, utilisez Windows pour le lancer et suivez les invites du programme d'installation. Après l'installation, vous pouvez désinstaller comme n'importe quelle application Windows.

Vous pouvez également utiliser le kitmsiexecÀ partir de l'invite de commande Windows pour installer en mode silencieux, activer la journalisation et désinstaller, tel qu'illustré dans les exemples suivants. RemplacezAWSKinesisTap.1.1.216.4.msi with the appropriate version of Kinesis Agent for Windows for your application.

Pour installer Kinesis Agent pour Windows en mode silencieux :

msiexec /i AWSKinesisTap.1.1.216.4.msi /q

Pour consigner les messages d'installation à des fins de dépannage dans un fichier nommélogfile.log :

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

Pour désinstaller Kinesis Agent pour Windows à l'aide de l'invite de commandes :

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

Installer Kinesis Agent pour Windows à l'aide d'AWS Systems Manager

Suivez ces étapes pour installer Kinesis Agent pour Windows à l'aide de la fonctionnalité Exécuter la commande Pour en savoir plus sur la fonctionnalité Exécuter la commande, consultezAWS Systems Managerdans leAWS Systems Manager. En plus d'utiliser la commande d'exécution de Systems Manager, vous pouvez également utiliser Systems ManagerFenêtres de maintenanceandState Managerpour automatiser le déploiement de Kinesis Agent pour Windows au fil du temps.

Installer Kinesis Agent pour Windows à l'aide de PowerShell

Utilisez un éditeur de texte pour copier les commandes suivantes dans un fichier et l'enregistrer en tant que script PowerShell. Nous utilisonsInstallKinesisAgent.ps1Dans l'exemple suivant.

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
}

Ouvrez une fenêtre d'invite de commande de niveau élevé. Dans le répertoire où le fichier a été téléchargé, utilisez la commande suivante pour exécuter le script :

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

Pour installer une version spécifique de Kinesis Agent pour Windows, ajoutez le kit-versionOption :

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

Remplacezversionavec un numéro de version de Kinesis Agent pour Windows valide. Pour plus d'informations sur la version, consultezréférentiel kinesis-agent-windows sur GitHub.

Il existe de nombreux outils de déploiement capables d'exécuter des scripts PowerShell à distance. Ils peuvent être utilisés pour automatiser l'installation de Kinesis Agent for Windows sur des flottes de serveurs ou des ordinateurs de bureau.

Configuration et démarrage de Kinesis Agent pour Windows

Après l'installation de Kinesis Agent pour Windows, vous devez configurer et démarrer l'agent. Après cette opération, aucune autre intervention ne devrait être nécessaire.