Skip to content
AWS for Query.Farm

aws.eks.describe_insight

Example SQL Queries

SELECT * FROM
aws.eks.describe_insight
WHERE
"cluster_name" = 'VALUE'
AND "id" = 'VALUE';

Description

Returns details about an insight that you specify using its ID.

Table Definition

Column NameColumn Data Type
cluster_name Required Input Column

The name of the cluster to describe the insight for.

VARCHAR
id Required Input Column

The identity of the insight to describe.

VARCHAR
_aws_profile Input Column

The AWS profile defines the AWS identity used. It can be defined via credentials or by assuming a IAM role.

STRUCT(
    "type" VARCHAR,
    "name" VARCHAR,
    "account_id" VARCHAR,
    "via_profile_name" VARCHAR,
    "assumed_role_arn" VARCHAR,
    "organization" STRUCT(
        "account_name" VARCHAR,
        "id" VARCHAR,
        "tags" STRUCT(
            "key" VARCHAR,
            "value" VARCHAR
        )[],
        "master_account" STRUCT(
            "id" VARCHAR,
            "email" VARCHAR
        ),
        "parents" STRUCT(
            "type" VARCHAR,
            "id" VARCHAR,
            "name" VARCHAR,
            "tags" STRUCT(
                "key" VARCHAR,
                "value" VARCHAR
            )[]
        )[]
    )
)
Show child fields
_aws_profile.account_id

The AWS account id

_aws_profile.assumed_role_arn

The ARN of the assumed role

_aws_profile.name

The unique name of the profile.

_aws_profile.organization

Information about this profile's membership in the AWS organization.

Show child fields
_aws_profile.organization.account_name

The name of account speciifed by the organization

_aws_profile.organization.id

The organization id

_aws_profile.organization.master_account
Show child fields
_aws_profile.organization.master_account.email

The organization master account email address

_aws_profile.organization.master_account.id

The organization master account id

_aws_profile.organization.parents[]
Show child fields
_aws_profile.organization.parents[].id

The id of the parent

_aws_profile.organization.parents[].name

The name of the parent

_aws_profile.organization.parents[].tags[]
Show child fields
_aws_profile.organization.parents[].tags[].key
_aws_profile.organization.parents[].tags[].value
_aws_profile.organization.parents[].type

The type of parent can be an organization unit or a root

_aws_profile.organization.tags[]
Show child fields
_aws_profile.organization.tags[].key
_aws_profile.organization.tags[].value
_aws_profile.type

The type of profile, either 'credentials' or 'assumed_role'

_aws_profile.via_profile_name

This IAM role for this profile is assumed by first utilizing another profile with this name to obtain credentials.

_aws_region Input Column

The AWS region to use.

VARCHAR
insight

The full description of the insight.

STRUCT(
    "id" VARCHAR,
    "name" VARCHAR,
    "category" VARCHAR,
    "kubernetes_version" VARCHAR,
    "last_refresh_time" TIMESTAMP_S,
    "last_transition_time" TIMESTAMP_S,
    "description" VARCHAR,
    "insight_status" STRUCT(
        "status" VARCHAR,
        "reason" VARCHAR
    ),
    "recommendation" VARCHAR,
    "additional_info" MAP(VARCHAR, VARCHAR),
    "resources" STRUCT(
        "insight_status" STRUCT(
            "status" VARCHAR,
            "reason" VARCHAR
        ),
        "kubernetes_resource_uri" VARCHAR,
        "arn" VARCHAR
    )[],
    "category_specific_summary" STRUCT(
        "deprecation_details" STRUCT(
            "usage" VARCHAR,
            "replaced_with" VARCHAR,
            "stop_serving_version" VARCHAR,
            "start_serving_replacement_version" VARCHAR,
            "client_stats" STRUCT(
                "user_agent" VARCHAR,
                "number_of_requests_last30_days" BIGINT,
                "last_request_time" TIMESTAMP_S
            )[]
        )[]
    )
)
Show child fields
insight.additional_info

Links to sources that provide additional context on the insight.

insight.category

The category of the insight.

insight.category_specific_summary

Summary information that relates to the category of the insight. Currently only returned with certain insights having category UPGRADE_READINESS.

Show child fields
insight.category_specific_summary.deprecation_details[]
Show child fields
insight.category_specific_summary.deprecation_details[].client_stats[]
Show child fields
insight.category_specific_summary.deprecation_details[].client_stats[].last_request_time

The timestamp of the last request seen from the Kubernetes client.

insight.category_specific_summary.deprecation_details[].client_stats[].number_of_requests_last30_days

The number of requests from the Kubernetes client seen over the last 30 days.

insight.category_specific_summary.deprecation_details[].client_stats[].user_agent

The user agent of the Kubernetes client using the deprecated resource.

insight.category_specific_summary.deprecation_details[].replaced_with

The newer version of the resource to migrate to if applicable.

insight.category_specific_summary.deprecation_details[].start_serving_replacement_version

The version of the software where the newer resource version became available to migrate to if applicable.

insight.category_specific_summary.deprecation_details[].stop_serving_version

The version of the software where the deprecated resource version will stop being served.

insight.category_specific_summary.deprecation_details[].usage

The deprecated version of the resource.

insight.description

The description of the insight which includes alert criteria, remediation recommendation, and additional resources (contains Markdown).

insight.id

The ID of the insight.

insight.insight_status

An object containing more detail on the status of the insight resource.

Show child fields
insight.insight_status.reason

Explanation on the reasoning for the status of the resource.

insight.insight_status.status

The status of the resource.

insight.kubernetes_version

The Kubernetes minor version associated with an insight if applicable.

insight.last_refresh_time

The time Amazon EKS last successfully completed a refresh of this insight check on the cluster.

insight.last_transition_time

The time the status of the insight last changed.

insight.name

The name of the insight.

insight.recommendation

A summary of how to remediate the finding of this insight if applicable.

insight.resources[]
Show child fields
insight.resources[].arn

The Amazon Resource Name (ARN) if applicable.

insight.resources[].insight_status

An object containing more detail on the status of the insight resource.

Show child fields
insight.resources[].insight_status.reason

Explanation on the reasoning for the status of the resource.

insight.resources[].insight_status.status

The status of the resource.

insight.resources[].kubernetes_resource_uri

The Kubernetes resource URI if applicable.