Memulai dengan Amazon Kinesis Agent for Microsoft Windows

Anda dapat menggunakan Amazon Kinesis Agent for Microsoft Windows (Kinesis Agent for Windows) untuk mengumpulkan, mengurai, mentransformasi, dan mengalirkan log, peristiwa, dan metrik dari armada Windows Anda ke berbagai layanan AWS. Informasi berikut berisi prasyarat dan petunjuk langkah demi langkah untuk menginstal dan mengonfigurasi Kinesis Agent for Windows.

Prerequisites

Sebelum menginstal Kinesis Agent for Windows, pastikan Anda memiliki prasyarat berikut:

Menyiapkan Akun AWS

Jika Anda tidak memiliki Akun AWS, selesaikan langkah berikut untuk membuatnya.

Anda dapat menggunakan proses yang sama untuk membuat lebih banyak grup dan pengguna serta untuk memberi pengguna Anda akses ke sumber daya Akun AWS Anda. Untuk mempelajari tentang menggunakan kebijakan yang membatasi izin pengguna untuk sumber daya AWS khusus, lihat Manajemen akses dan Contoh kebijakan.

Menginstal Kinesis Agent for Windows

Ada tiga cara untuk menginstal Kinesis Agent for Windows di Windows:

Instal Kinesis Agent for Windows menggunakan MSI

Anda dapat mengunduh paket MSI Kinesis Agent for Windows terbaru dari repositori kinesis-agent-windows di GitHub. Setelah mengunduh MSI, gunakan Windows untuk meluncurkannya dan ikuti petunjuk penginstal. Setelah instalasi, Anda dapat mencopot instalasinya seperti pada aplikasi Windows lainnya.

Atau, Anda dapat menggunakan perintah msiexec dari command prompt Windows untuk menginstal secara tersembunyi, mengaktifkan pencatatan, dan mencopot instalasinya seperti yang ditunjukkan dalam contoh berikut. Ganti AWSKinesisTap.1.1.216.4.msi with the appropriate version of Kinesis Agent for Windows for your application.

Untuk menginstal Kinesis Agent for Windows secara tersembunyi:

msiexec /i AWSKinesisTap.1.1.216.4.msi /q

Untuk mencatat pesan instalasi untuk pemecahan masalah dalam file bernama logfile.log:

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

Untuk mencopot instalasi Kinesis Agent for Windows menggunakan command prompt:

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

Instal Kinesis Agent for Windows menggunakan AWS Systems Manager

Ikuti langkah-langkah ini untuk menginstal Kinesis Agent for Windows menggunakan Run Command Systems Manager. Untuk informasi selengkapnya tentang Run Command, lihat AWS Systems Manager Run Command dalam Panduan Pengguna AWS Systems Manager. Selain menggunakan Run Command Systems Manager, Anda juga dapat menggunakan Jendela Pemeliharaan dan State Manager Systems Manager untuk mengotomatisasi deployment Kinesis Agent for Windows dari waktu ke waktu.

Instal Kinesis Agent for Windows Menggunakan PowerShell

Gunakan editor teks untuk menyalin perintah berikut ke dalam file dan menyimpannya sebagai skrip PowerShell. Kami menggunakan InstallKinesisAgent.ps1 dalam contoh berikut ini.

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
}

Buka jendela command prompt untuk administrator (elevated). Di direktori tempat file diunduh, gunakan perintah berikut untuk menjalankan skrip:

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

Untuk menginstal versi tertentu Kinesis Agent for Windows, tambahkan opsi -version:

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

Ganti versi dengan nomor versi Kinesis Agent for Windows yang valid. Untuk informasi versi, lihat repositori kinesis-agent-windows pada GitHub.

Ada banyak alat deployment yang dapat menjalankan skrip PowerShell dari jarak jauh. Alat ini dapat digunakan untuk mengotomatisasi instalasi Kinesis Agent for Windows pada armada server atau desktop.

Mengonfigurasi dan Menjalankan Kinesis Agent for Windows

Setelah menginstal Kinesis Agent for Windows, Anda harus mengonfigurasi dan menjalankan agen. Setelah itu, tidak diperlukan intervensi pengoperasian lebih lanjut.