翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Microsoft Windows 用 Amazon Kinesis エージェントの使用開始

Amazon Kinesis Agent for Microsoft Windows (Kinesis Agent for Windows) を使用すると、Windows フリートから AWS サービスにログ、イベント、およびメトリクスを収集、解析、変換、およびストリーミング配信できます。以下の情報には、Kinesis Agent for Windows をインストールおよび設定するための前提条件と詳細な手順が含まれています。

Prerequisites

Windows 用 Kinesis Agent をインストールする前に、次の前提条件が揃っていることを確認してください。

AWS アカウントのセットアップ

AWS アカウントをお持ちでない場合は、以下の手順に従ってアカウントを作成してください。

このプロセスを繰り返して新しいグループとユーザーを作成して、AWS アカウントのリソースへのアクセス許可をユーザーに付与できます。ポリシーを使用して特定の AWS のリソースへのユーザーのアクセス許可を制限する方法については、「AWS リソースのアクセス管理」と「IAM アイデンティティベースのポリシーの例」を参照してください。

Windows 用 Kinesis エージェントのインストール

Windows に Kinesis エージェントをインストールする方法は 3 つあります。

MSI を使用して Windows 用 Kinesis エージェントをインストールする

Windows MSI 用 Kinesis エージェントの最新の Windows MSI パッケージは、GitHub 上のキネシス-エージェント-ウィンドウのリポジトリ。MSIをダウンロードしたら、Windowsを使用してMSIを起動し、インストーラの指示に従います。インストール後、Windowsアプリケーションと同じようにアンインストールできます。

または、[] を使用することもできます。msiexecコマンドを実行して、次の例に示すように、Windows のコマンドプロンプトから Windows のコマンドプロンプトからインストールし、ログ記録を有効にし、アンインストールします。置換AWSKinesisTap.1.1.216.4.msi with the appropriate version of Kinesis Agent for Windows for your application.

Windows 用 Kinesis エージェントをサイレントインストールするには

msiexec /i AWSKinesisTap.1.1.216.4.msi /q

トラブルシューティング用のインストールメッセージをlogfile.log:

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

コマンドプロンプトを使用して Kinesis エージェント for Windows をアンインストールするには

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

AWS Systems Manager を使用して Windows 用 Kinesis エージェントをインストールする

Systems Manager の実行コマンドを使用して Windows 用 Kinesis エージェントをインストールするには、以下の手順を実行します。Run Command の詳細については、」AWS Systems Manager の実行コマンド()AWS Systems Manager ユーザーガイド。Systems Manager Run コマンドを使用することに加えて、Systems Manager を使用することもできます。メンテナンスウィンドウおよびステートマネージャーを使用して、Windows 用 Kinesis エージェントの展開を時間の経過とともに自動化します。

PowerShell を使用して Windows 用 Kinesis エージェントをインストールする

テキストエディタを使用して、次のコマンドをファイルにコピーし、PowerShell スクリプトとして保存します。私たちはInstallKinesisAgent.ps1以下に例を示します。

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
}

昇格されたコマンドプロンプトウィンドウを開きます。ファイルがダウンロードされたディレクトリで、次のコマンドを使用してスクリプトを実行します。

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

Windows 用 Kinesis エージェントの特定のバージョンをインストールするには、-versionオプション:

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

置換バージョンを Windows 用の有効な Kinesis エージェントのバージョン番号で設定します。バージョンについては、「」を参照してください。GitHub 上のキネシス-エージェント-ウィンドウのリポジトリ。

PowerShell スクリプトをリモートで実行できる多くのデプロイツールがあります。これらのツールを使用すると、サーバーまたはデスクトップのフリートへの Kinesis Agent for Windows のインストールを自動化できます。

Windows 用 Kinesis エージェントの設定と起動

Windows 用 Kinesis Agent をインストールしたら、エージェントを設定および開始する必要があります。その後は、オペレーションの介入は不要です。