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
<a name="getting-started"></a>

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.

**Topics**
+ [Prerequisites](#getting-started-prerequisites)
+ [Configuration d'un compte AWS](#getting-started-setting-up)
+ [Installation de Kinesis Agent pour Windows](#getting-started-installation)
+ [Configuration et démarrage de Kinesis Agent pour Windows](#getting-started-start-service)

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

Avant d'installer Kinesis Agent pour Windows, veillez à disposer des prérequis suivants :
+ Connaissance des concepts Kinesis Agent for Windows. Pour plus d'informations, consultez [Amazon Kinesis Agent pour Microsoft Windows Concepts](kinesis-agent-windows-concepts.md).
+ Un compte AWS permettant d'utiliser les différents services AWS liés à votre pipeline de données. Pour plus d'informations sur la création et la configuration d'un compte AWS, consultez [Configuration d'un compte AWS](#getting-started-setting-up).
+ Microsoft .NET Framework 4.6 ou une version ultérieure sur chaque ordinateur de bureau ou serveur qui exécutera Kinesis Agent pour Windows. Pour plus d'informations, consultez [Install the .NET Framework for developers](https://docs.microsoft.com/en-us/dotnet/framework/install/guide-for-developers) dans la documentation Microsoft .NET.

  Pour déterminer la version la plus récente de .NET Framework installée sur un ordinateur de bureau ou un serveur, utilisez le script PowerShell suivant :

  ```
       [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
  ```
+ Vous disposez des flux qui vous permettront d'envoyer des données à partir de Kinesis Agent for Windows (si vous utilisez Amazon Kinesis Data Streams). Créez les flux à l'aide de l'outil[Console Kinesis Data Streams](https://console.aws.amazon.com/kinesis/), le[AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html), ou[Outils AWS pour Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/reference/items/New-KINStream.html). Pour de plus amples informations, veuillez consulter[Création et mise à jour des flux de données](https://docs.aws.amazon.com/streams/latest/dev/amazon-kinesis-streams.html)dans le*Amazon Kinesis Data Streams*.
+ Vous disposez des flux de diffusion Firehose qui vous permettront d'envoyer des données à partir de Kinesis Agent pour Windows (si vous utilisez Amazon Kinesis Data Firehose). Créez des flux de livraison à l'aide du[Kinesis Data Firehose](https://console.aws.amazon.com/firehose/), le[AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/firehose/create-delivery-stream.html), ou[Outils AWS pour Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/reference/items/New-KINFDeliveryStream.html). Pour plus d'informations, consultez [Création d'un flux de diffusion Amazon Kinesis Data Firehose ](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) dans le *Guide du développeur Amazon Kinesis Data Firehose*.

## Configuration d'un compte AWS
<a name="getting-started-setting-up"></a>

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

**Pour créer un compte AWS**

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

1. Suivez les instructions en ligne.

   Dans le cadre de la procédure d'inscription, vous recevrez un appel téléphonique et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.

**Pour créer un administrateur pour vous-même et ajouter l'utilisateur à un groupe d'administrateurs (console)**

1. Connectez-vous à la [IAM console (Console IAM)](https://console.aws.amazon.com/iam/) en tant que propriétaire du compte en choisissant **Root user (Utilisateur racine)** et en entrant l'adresse e-mail de votre compte AWS. Sur la page suivante, saisissez votre mot de passe.
**Note**  
Nous vous recommandons vivement de respecter la bonne pratique qui consiste à avoir recours à**Administrator**Utilisateur IAM qui suit et verrouille en sécurité les informations d'identification de l'utilisateur racine. Connectez-vous en tant qu'utilisateur racine pour effectuer certaines [tâches de gestion des comptes et des services](https://docs.aws.amazon.com/general/latest/gr/aws_tasks-that-require-root.html).

1. Dans le panneau de navigation, choisissez **Utilisateurs**, puis **Add user (Ajouter un utilisateur)**.

1. Dans **User name (Nom d'utilisateur)**, entrez **Administrator**.

1. Activez la case à cocher en regard de l'**accès à AWS Management Console**. Puis, sélectionnez **Mot de passe personnalisé**, et saisissez votre nouveau mot de passe dans la zone de texte.

1. Par défaut, AWS oblige le nouvel utilisateur à créer un nouveau mot de passe lors de sa première connexion. Décochez la case en regard de **User must create a new password at next sign-in (L'utilisateur doit créer un nouveau mot de passe à sa prochaine connexion)** pour autoriser le nouvel utilisateur à réinitialiser son mot de passe une fois qu'il s'est connecté.

1. Choisissez**Suivant: Autorisations.**

1. Sous **Set permissions (Accorder des autorisations)**, choisissez **Add user to group (Ajouter un utilisateur au groupe)**.

1. Choisissez **Create group**.

1. Dans la boîte de dialogue **Create group (Créer un groupe)**, pour **Group name (Nom du groupe)**, tapez **Administrators**.

1. Choisissez**Stratégies de filtre**, puis**Gestion d'AWS - fonction de travail**pour filtrer le contenu de la table.

1. Dans la liste des stratégies, cochez la case **AdministratorAccess**. Choisissez ensuite **Create group**.
**Note**  
Vous devez activer l'accès de l'utilisateur et du rôle IAM à la facturation avant de pouvoir utiliser les autorisations `AdministratorAccess` pour accéder à la console AWS Billing and Cost Management. Pour ce faire, suivez les instructions de l'[étape 1 du didacticiel portant sur comment déléguer l'accès à la console de facturation](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_billing.html).

1. De retour dans la liste des groupes, activez la case à cocher du nouveau groupe. Choisissez **Refresh** si nécessaire pour afficher le groupe dans la liste.

1. Choisissez**Suivant: Tags (Balises)**.

1. (Facultatif) Ajoutez des métadonnées à l'utilisateur en associant les balises sous forme de paires clé-valeur. Pour de plus amples informations sur l'utilisation des balises dans IAM, veuillez consulter [Balisage des utilisateurs et des rôles IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) dans le *Guide de l'utilisateur IAM*.

1. Choisissez**Suivant: Vérification**Pour afficher la liste des membres du groupe à ajouter au nouvel utilisateur. Une fois que vous êtes prêt à continuer, choisissez **Create user**.

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](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) et [Exemples de stratégies](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_examples.html).

**Pour vous inscrire sur AWS et créer un compte d'administrateur**

1. Si vous n'avez pas de compte[https://aws.amazon.com/](https://aws.amazon.com/). Choisissez **Créer un compte AWS**, puis suivez les instructions en ligne.

   Dans le cadre de la procédure d'inscription, vous recevrez un appel téléphonique et vous saisirez un code PIN en utilisant le clavier numérique du téléphone.

1. Connectez-vous à AWS Management Console et ouvrez la console IAM à l'adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Dans le volet de navigation, choisissez **Groups**, puis **Create New Group**.

1. Dans **Nom du groupe**, entrez un nom pour le groupe, par exemple **Administrators**, puis choisissez **Étape suivante**.

1. Dans la liste des stratégies, sélectionnez la case à cocher en regard de la stratégie **AdministratorAccess**. Vous pouvez utiliser le menu **Filter** et la zone **Search** pour filtrer la liste de stratégies.

1. Choisissez **Next Step**. Choisissez **Créer un groupe**. Votre nouveau groupe apparaît ensuite sous **Nom du groupe**.

1. Dans le volet de navigation, choisissez **Users**, puis **Create New Users**.

1. Dans la zone **1**, saisissez un nom d'utilisateur, décochez la case en regard de **Générez une clé d'accès pour chaque utilisateur**, puis choisissez **Créer**.

1. Dans la liste des utilisateurs, sélectionnez le nom (et non pas la case à cocher) de l'utilisateur que vous venez de créer. Vous pouvez utiliser la zone **Recherche** pour rechercher le nom utilisateur.

1. Choisissez l'onglet **Groupes**, puis sélectionnez **Ajouter un utilisateur aux groupes**.

1. Cochez la case en regard du groupe d'administrateurs, puis choisissez **Ajouter aux groupes**.

1. Choisissez l'onglet **Informations d'identification de sécurité**. Sous **Sign-In Credentials**, choisissez **Manage Password**.

1. Sélectionnez **Affecter un mot de passe personnalisé**, saisissez un mot de passe dans les zones **Mot de passe** et **Confirmer le mot de passe**, puis choisissez **Appliquer**.

## Installation de Kinesis Agent pour Windows
<a name="getting-started-installation"></a>

Vous pouvez installer Kinesis Agent pour Windows sous Windows trois façons :
+ Installez à l'aide de MSI (package d'installation Windows).
+ Installez à[AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/), un ensemble de services permettant d'administrer les serveurs et les ordinateurs de bureau.
+ Exécuter un script PowerShell.

**Note**  
Les instructions suivantes utilisent occasionnellement les termes *KinesisTap* et *AWSKinesisTap*. Ces termes ont la même signification que Kinesis Agent pour Windows, mais vous devez les spécifier tels quels lorsque vous exécutez ces instructions.

### Installer Kinesis Agent pour Windows à l'aide de MSI
<a name="install-msi"></a>

Vous pouvez télécharger le dernier package Kinesis Agent pour Windows MSI à partir du[référentiel kinesis-agent-windows sur GitHub](https://github.com/awslabs/kinesis-agent-windows/releases). 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 kit[msiexec](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec)À 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. Remplacez`AWSKinesisTap.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
<a name="install-systems-manager"></a>

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, consultez[AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/execute-remote-commands.html)dans le*AWS Systems Manager*. En plus d'utiliser la commande d'exécution de Systems Manager, vous pouvez également utiliser Systems Manager[Fenêtres de maintenance](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-maintenance.html)and[State Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-state.html)pour automatiser le déploiement de Kinesis Agent pour Windows au fil du temps.

**Note**  
L'installation de Systems Manager pour Kinesis Agent for Windows est disponible dans les régions[AWS Systems Manager](https://docs.aws.amazon.com/general/latest/gr/rande.html#ssm_region)À l'exception des éléments suivants :  
cn-north-1
cn-northwest-1
Toutes les régions AWS GovCloud

**Pour installer Kinesis Agent pour Windows à l'aide du Systems Manager**

1. Vérifiez que la version 2.58.0 ou une version ultérieure de l'agent SSM est installée sur les instances dans lesquelles vous souhaitez installer Kinesis Agent pour Windows. Pour de plus amples informations, veuillez consulter[Installation et configuration de l'agent SSM sur les instances Windows](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html)dans le*AWS Systems Manager*.

1. Ouvrez la console AWS Systems Manager à l'adresse[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le volet de navigation,**Gestion des nœuds**, choisissez**Fonctionnalité Exécuter la commande**, puis**Fonctionnalité Exécuter la commande**.

1. À partir du**Document de commande**, sélectionnez**AWS-ConfigureAWSPackage**document.  
![\[Sélectionnez le document AWS-ConfigureAWSPackage.\]](http://docs.aws.amazon.com/fr_fr/kinesis-agent-windows/latest/userguide/images/runcommand-document-select.png)

1. UNDER**Paramètres de commande**, pour**Nom**, saisissez**AWSKineSISTAP**. Conservez les valeurs par défaut des autres paramètres.
**Note**  
quitter**Version**Pour spécifier la dernière version du package AWSKineSistap. Éventuellement, vous pouvez saisir une version spécifique à installer.  
![\[Spécifiez le package AWSkineSistap dans les paramètres de commande.\]](http://docs.aws.amazon.com/fr_fr/kinesis-agent-windows/latest/userguide/images/runcommand-specify-options.png)

1. UNDER**Cibles**, spécifiez les instances sur lesquelles exécuter la commande. Vous pouvez choisir de spécifier des instances en fonction des balises associées aux instances, vous pouvez choisir des instances manuellement ou vous pouvez spécifier un groupe de ressources qui inclut des instances.

1. Conservez les valeurs par défaut de tous les autres paramètres et choisissez**Run (Exécuter Lambda)**.

### Installer Kinesis Agent pour Windows à l'aide de PowerShell
<a name="install-ps"></a>

Utilisez un éditeur de texte pour copier les commandes suivantes dans un fichier et l'enregistrer en tant que script PowerShell. Nous utilisons`InstallKinesisAgent.ps1`Dans 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`-version`Option :

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

Remplacez*version*avec un numéro de version de Kinesis Agent pour Windows valide. Pour plus d'informations sur la version, consultez[référentiel kinesis-agent-windows sur GitHub](https://github.com/awslabs/kinesis-agent-windows/blob/master/README.md).

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
<a name="getting-started-start-service"></a>

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.

**Pour configurer et démarrer Kinesis Agent**

1. Créez et déployez un fichier de configuration Kinesis Agent for Windows. Ce fichier configure les sources, les récepteurs et les canaux, ainsi que d'autres éléments de la configuration globale. 

   Pour en savoir plus sur la configuration de Kinesis Agent for Windows, consultez[Configuration d'Amazon Kinesis Agent pour Microsoft Windows](configuring-kinesis-agent-windows.md).

   Pour obtenir des exemples complets de fichiers de configuration à personnaliser et installer, consultez [Exemples de configuration de l'agent Kinesis pour Windows](configuring-kaw-examples.md).

1. Ouvrez une fenêtre d'invite de commande PowerShell avec élévation de privilèges et démarrez Kinesis Agent pour Windows à l'aide de la commande PowerShell suivante :

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