AWSSupport-TroubleshootSessionManager - AWS Systems Manager Referensi buku runbook otomatisasi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWSSupport-TroubleshootSessionManager

Deskripsi

AWSSupport-TroubleshootSessionManagerRunbook membantu Anda memecahkan masalah umum yang mencegah Anda terhubung ke instans Amazon Elastic Compute Cloud (Amazon EC2) yang dikelola menggunakan Session Manager. Session Manager adalah alat di AWS Systems Manager. Runbook ini memeriksa hal-hal berikut:

  • Memeriksa apakah instans berjalan dan melaporkan seperti yang dikelola oleh Systems Manager.

  • Menjalankan AWSSupport-TroubleshootManagedInstance runbook jika instance tidak melaporkan seperti yang dikelola oleh Systems Manager.

  • Memeriksa versi Agen SSM yang diinstal pada instance.

  • Memeriksa apakah profil instans yang berisi kebijakan direkomendasikan AWS Identity and Access Management (IAM) untuk Pengelola Sesi dilampirkan ke EC2 instans Amazon.

  • Mengumpulkan log Agen SSM dari instance.

  • Menganalisis preferensi Manajer Sesi Anda.

  • Menjalankan AWSSupport-AnalyzeAWSEndpointReachabilityFromEC2 runbook untuk menganalisis konektivitas instans ke titik akhir untuk Session Manager, AWS Key Management Service (AWS KMS), Amazon Simple Storage Service (Amazon S3), dan Amazon CloudWatch Logs (Log). CloudWatch

Pertimbangan-pertimbangan

  • Node terkelola hibrida tidak didukung.

  • Runbook ini hanya memeriksa apakah kebijakan IAM terkelola yang direkomendasikan dilampirkan ke profil instance. Itu tidak menganalisis IAM atau AWS KMS izin yang terkandung dalam profil instans Anda.

penting

AWSSupport-AnalyzeAWSEndpointReachabilityFromEC2Runbook menggunakan VPC Reachability Analyzer untuk menganalisis konektivitas jaringan antara sumber dan titik akhir layanan. Anda dikenakan biaya per analisis yang dijalankan antara sumber dan tujuan. Untuk detail selengkapnya, lihat Harga Amazon VPC.

Jalankan Otomasi ini (konsol)

Jenis dokumen

Otomatisasi

Pemilik

Amazon

Platform

Linux,macOS, Windows

Parameter

  • AutomationAssumeRole

    Tipe: String

    Deskripsi: (Opsional) Nama Sumber Daya Amazon (ARN) peran AWS Identity and Access Management (IAM) yang memungkinkan Otomasi Systems Manager untuk melakukan tindakan atas nama Anda. Jika tidak ada peran yang ditentukan, Systems Manager Automation menggunakan izin pengguna yang memulai runbook ini.

  • InstanceId

    Tipe: String

    Deskripsi: (Wajib) ID EC2 instans Amazon yang tidak dapat Anda sambungkan menggunakan Pengelola Sesi.

  • SessionPreferenceDocument

    Tipe: String

    Default: SSM- SessionManagerRunShell

    Deskripsi: (Opsional) Nama dokumen preferensi sesi Anda. Jika Anda tidak menentukan dokumen preferensi sesi kustom saat memulai sesi, gunakan nilai default.

Izin IAM yang diperlukan

AutomationAssumeRoleParameter memerlukan tindakan berikut untuk menggunakan runbook dengan sukses.

  • ec2:CreateNetworkInsightsPath

  • ec2:DeleteNetworkInsightsAnalysis

  • ec2:DeleteNetworkInsightsPath

  • ec2:StartNetworkInsightsAnalysis

  • tiros:CreateQuery

  • ec2:DescribeAvailabilityZones

  • ec2:DescribeCustomerGateways

  • ec2:DescribeDhcpOptions

  • ec2:DescribeInstances

  • ec2:DescribeInstanceStatus

  • ec2:DescribeInternetGateways

  • ec2:DescribeManagedPrefixLists

  • ec2:DescribeNatGateways

  • ec2:DescribeNetworkAcls

  • ec2:DescribeNetworkInsightsAnalyses

  • ec2:DescribeNetworkInsightsPaths

  • ec2:DescribeNetworkInterfaces

  • ec2:DescribePrefixLists

  • ec2:DescribeRegions

  • ec2:DescribeRouteTables

  • ec2:DescribeSecurityGroups

  • ec2:DescribeSubnets

  • ec2:DescribeTransitGatewayAttachments

  • ec2:DescribeTransitGatewayConnects

  • ec2:DescribeTransitGatewayPeeringAttachments

  • ec2:DescribeTransitGatewayRouteTables

  • ec2:DescribeTransitGateways

  • ec2:DescribeTransitGatewayVpcAttachments

  • ec2:DescribeVpcAttribute

  • ec2:DescribeVpcEndpoints

  • ec2:DescribeVpcEndpointServiceConfigurations

  • ec2:DescribeVpcPeeringConnections

  • ec2:DescribeVpcs

  • ec2:DescribeVpnConnections

  • ec2:DescribeVpnGateways

  • ec2:GetManagedPrefixListEntries

  • ec2:GetTransitGatewayRouteTablePropagations

  • ec2:SearchTransitGatewayRoutes

  • elasticloadbalancing:DescribeListeners

  • elasticloadbalancing:DescribeLoadBalancerAttributes

  • elasticloadbalancing:DescribeLoadBalancers

  • elasticloadbalancing:DescribeRules

  • elasticloadbalancing:DescribeTags

  • elasticloadbalancing:DescribeTargetGroups

  • elasticloadbalancing:DescribeTargetHealth

  • iam:GetInstanceProfile

  • iam:ListAttachedRolePolicies

  • iam:ListRoles

  • iam:PassRole

  • ssm:DescribeAutomationStepExecutions

  • ssm:DescribeInstanceInformation

  • ssm:GetAutomationExecution

  • ssm:GetDocument

  • ssm:ListCommands

  • ssm:ListCommandInvocations

  • ssm:SendCommand

  • ssm:StartAutomationExecution

  • tiros:GetQueryAnswer

  • tiros:GetQueryExplanation

Langkah Dokumen

  1. aws:waitForAwsResourceProperty: Menunggu hingga 6 menit agar instans target Anda lulus pemeriksaan status.

  2. aws:executeScript: Mem-parsing dokumen preferensi sesi.

  3. aws:executeAwsApi: Mendapat ARN dari profil instance yang dilampirkan ke instance Anda.

  4. aws:executeAwsApi: Memeriksa apakah instans Anda melaporkan seperti yang dikelola oleh Systems Manager.

  5. aws:branch: Cabang berdasarkan apakah instans Anda melaporkan seperti yang dikelola oleh Systems Manager.

  6. aws:executeScript: Memeriksa apakah Agen SSM yang diinstal pada instans Anda mendukung Session Manager.

  7. aws:branch: Cabang berdasarkan platform instans Anda untuk mengumpulkan ssm-cli log.

  8. aws:runCommand: Mengumpulkan log output dari ssm-cli dari Linux atau macOS instance.

  9. aws:runCommand: Mengumpulkan log output dari ssm-cli dari sebuah Windows instance.

  10. aws:executeScript: Mem-parsing ssm-cli log.

  11. aws:executeScript: Memeriksa apakah kebijakan IAM yang direkomendasikan dilampirkan ke profil instance.

  12. aws:branch: Menentukan apakah akan mengevaluasi konektivitas ssmmessages titik akhir berdasarkan ssm-cli log.

  13. aws:executeAutomation: Mengevaluasi apakah instance dapat terhubung ke titik ssmmessages akhir.

  14. aws:branch: Menentukan apakah akan mengevaluasi konektivitas titik akhir Amazon S3 berdasarkan ssm-cli log dan preferensi sesi Anda.

  15. aws:executeAutomation: Mengevaluasi apakah instans dapat terhubung ke titik akhir Amazon S3.

  16. aws:branch: Menentukan apakah akan mengevaluasi konektivitas AWS KMS titik akhir berdasarkan ssm-cli log dan preferensi sesi Anda.

  17. aws:executeAutomation: Mengevaluasi apakah instance dapat terhubung ke titik AWS KMS akhir.

  18. aws:branch: Menentukan apakah akan mengevaluasi CloudWatch konektivitas titik akhir ssm-cli Log berdasarkan log dan preferensi sesi Anda.

  19. aws:executeAutomation: Mengevaluasi apakah instance dapat terhubung ke titik akhir CloudWatch Log.

  20. aws:executeAutomation: Menjalankan AWSSupport-TroubleshootManagedInstance runbook.

  21. aws:executeScript: Mengkompilasi output dari langkah-langkah sebelumnya dan mengeluarkan laporan.

Ouput

  • generateReport.EvalReport- Hasil pemeriksaan yang dilakukan oleh runbook dalam teks biasa.