CloudWatch 로그를 사용하여 Amazon Data Firehose 모니터링 - Amazon Data Firehose

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CloudWatch 로그를 사용하여 Amazon Data Firehose 모니터링

Amazon Data Firehose는 Amazon CloudWatch Logs와 통합되어 데이터 변환 또는 데이터 전송을 위한 Lambda 호출이 실패할 때 특정 오류 로그를 볼 수 있습니다. Firehose 스트림을 생성할 때 Amazon Data Firehose 오류 로깅을 활성화할 수 있습니다.

Amazon Data Firehose 콘솔에서 Amazon Data Firehose 오류 로깅을 활성화하면 사용자를 대신하여 Firehose 스트림에 대한 로그 그룹 및 해당 로그 스트림이 생성됩니다. 로그 그룹 이름의 형식은 이며/aws/kinesisfirehose/delivery-stream-name, 여기서 delivery-stream-name는 해당 Firehose 스트림의 이름입니다. DestinationDelivery 는 기본 대상으로의 전송과 관련된 오류를 로깅하는 데 생성되고 사용되는 로그 스트림입니다. BackupDelivery(이)라는 또 다른 로그 스트림은 대상에 대해 S3 백업이 활성화된 경우에만 생성됩니다. BackupDelivery 로그 스트림은 S3 백업으로 전송하는 것과 관련된 오류를 기록하는 데 사용됩니다.

예를 들어, Amazon Redshift를 대상으로 하여 Firehose 스트림 “MyStream”을 생성하고 Amazon Data Firehose 오류 로깅을 활성화하면 라는 로그 그룹aws/kinesisfirehose/MyStream과 및 DestinationDelivery 라는 두 개의 로그 스트림이 사용자를 대신하여 생성됩니다BackupDelivery. 이 예시에서 DestinationDelivery은(는) Amazon Redshift 대상 및 중간 S3 대상으로의 전송과 관련된 오류를 기록하는 데 사용됩니다. BackupDelivery, S3 백업이 활성화된 경우 S3 백업 버킷으로의 전송과 관련된 오류를 기록하는 데 사용됩니다.

CloudWatchLoggingOptions 구성을 AWS CloudFormation 사용하여 AWS CLI, API또는 를 통해 Amazon Data Firehose 오류 로깅을 활성화할 수 있습니다. 이렇게 하려면 로그 그룹과 로그 스트림을 미리 생성합니다. Amazon Data Firehose 오류 로깅 전용 로그 그룹 및 로그 스트림을 예약하는 것이 좋습니다. 또한 연결된 IAM 정책에 "logs:putLogEvents" 권한이 있는지 확인합니다. 자세한 내용은 Amazon Data Firehose로 액세스 제어 단원을 참조하십시오.

Amazon Data Firehose는 모든 전송 오류 로그가 CloudWatch 로그로 전송된다고 보장하지 않습니다. 전송 실패율이 높은 상황에서 Amazon Data Firehose는 전송 오류 로그를 CloudWatch 로그로 전송하기 전에 샘플링합니다.

CloudWatch 로그로 전송된 오류 로그에는 명목상의 요금이 부과됩니다. 자세한 내용은 Amazon CloudWatch 요금 섹션을 참조하세요.

데이터 전송 오류

다음은 각 Amazon Data Firehose 대상에 대한 데이터 전송 오류 코드 및 메시지 목록입니다. 각 오류 메시지는 문제를 해결하기 취해야 하는 적절한 조치도 설명합니다.

Amazon S3 데이터 전송 오류

Amazon Data Firehose는 다음과 같은 Amazon S3-related 오류를 CloudWatch 로그로 전송할 수 있습니다.

오류 코드 오류 메시지와 정보
S3.KMS.NotFoundException

“제공된 AWS KMS 키를 찾을 수 없습니다. 올바른 역할을 가진 유효한 AWS KMS 키라고 생각되는 것을 사용하는 경우 AWS KMS 키가 연결된 계정에 문제가 있는지 확인합니다.'

S3.KMS.RequestLimitExceeded

“S3 객체를 암호화하려고 시도하는 동안 초당 KMS 요청이 한도를 초과했습니다. 초당 제한을 늘리십시오."

자세한 정보는 AWS Key Management Service 개발자 안내서제한을 참조하세요.

S3.AccessDenied "액세스가 거부되었습니다. 제공된 IAM 역할에 대한 신뢰 정책이 Amazon Data Firehose가 역할을 수임하도록 허용하고 액세스 정책이 S3 버킷에 대한 액세스를 허용하는지 확인합니다.'
S3.AccountProblem “ AWS 계정에 문제가 있어 작업이 성공적으로 완료되지 않습니다. AWS Support에 문의하세요.”
S3.AllAccessDisabled "입력하신 계정에 대한 액세스가 거부되었습니다. AWS 지원팀에 문의하세요.”
S3.InvalidPayer "입력하신 계정에 대한 액세스가 거부되었습니다. AWS 지원팀에 문의하세요.”
S3.NotSignedUp "계정이 Amazon S3에 가입되지 않았습니다. 계정에 가입하거나 다른 계정을 사용하십시오."
S3.NoSuchBucket "지정된 버킷이 존재하지 않습니다. 버킷을 새로 만들거나, 다른 기존 버킷을 사용하십시오."
S3.MethodNotAllowed "지정된 방법이 이 리소스에 허용되지 않습니다. 올바른 Amazon S3 작업 권한을 허용하도록 버킷 정책을 수정하세요."
InternalError "데이터 전송을 시도하는 동안 내부 오류가 발생했습니다. 전송이 재시도됩니다. 오류가 지속되면 해결을 AWS 위해 에 보고됩니다.”
S3.KMS.KeyDisabled “제공된 KMS 키가 비활성화되었습니다. 키를 활성화하거나 다른 키를 사용하세요.”
S3.KMS.InvalidStateException “제공된 KMS 키가 유효하지 않은 상태입니다. 다른 키를 사용하세요.”
KMS.InvalidStateException “제공된 KMS 키가 유효하지 않은 상태입니다. 다른 키를 사용하세요.”
KMS.DisabledException “제공된 KMS 키가 비활성화되었습니다. 키를 수정하거나 다른 키를 사용하세요.”
S3.SlowDown “지정된 버킷에 대한 put 요청 비율이 너무 높았습니다. Firehose 스트림 버퍼 크기를 늘리거나 다른 애플리케이션의 풋 요청을 줄입니다.”
S3.SubscriptionRequired “S3를 호출하는 중 액세스가 거부되었습니다. 에 전달된 IAM 역할 및 KMS 키(제공된 경우)에 Amazon S3 구독이 있는지 확인합니다.'
S3.InvalidToken “입력된 토큰의 형식이 잘못되었거나 유효하지 않습니다. 입력된 자격 증명을 확인하세요.”
S3.KMS.KeyNotConfigured “KMS키가 구성되지 않았습니다. 를 구성KMSMasterKeyID하거나 S3 버킷에 대한 암호화를 비활성화합니다.”
S3.KMS.AsymmetricCMKNotSupported “Amazon S3는 대칭 만 지원합니다CMKs. 비대칭을 사용하여 Amazon S3에서 데이터를 CMK 암호화할 수 없습니다. 의 유형을 가져오려면 KMS DescribeKey 작업을 CMK사용합니다.
S3.IllegalLocationConstraintException “현재 Firehose는 구성된 s3 버킷으로 데이터를 전송하기 위해 s3 글로벌 엔드포인트를 사용합니다. 구성된 s3 버킷의 리전은 s3 글로벌 엔드포인트를 지원하지 않습니다. s3 버킷과 동일한 리전에서 Firehose 스트림을 생성하거나 글로벌 엔드포인트를 지원하는 리전에서 s3 버킷을 사용하세요.”
S3.InvalidPrefixConfigurationException “타임스탬프 평가에 사용된 사용자 지정 s3 접두사가 유효하지 않습니다. s3 접두사에 해당 연도의 현재 날짜 및 시간에 대한 올바른 표현식이 포함되어 있는지 확인하세요.”
DataFormatConversion.MalformedData “토큰 사이에 잘못된 문자가 있습니다.”

Apache Iceberg 테이블 데이터 전송 오류

Apache Iceberg Tables 데이터 전송 오류는 섹션을 참조하세요Amazon Data Firehose를 사용하여 Apache Iceberg 테이블에 데이터 전송.

Amazon Redshift 데이터 전송 오류

Amazon Data Firehose는 다음과 같은 Amazon Redshift 관련 오류를 CloudWatch 로그로 전송할 수 있습니다.

오류 코드 오류 메시지와 정보
Redshift.TableNotFound

"데이터를 로드할 테이블을 찾을 수 없습니다. 지정된 테이블이 있어야 합니다."

S3로부터 데이터를 복사해야 하는 Amazon Redshift의 대상 테이블을 찾을 수 없습니다. Amazon Data Firehose는 존재하지 않는 경우 Amazon Redshift 테이블을 생성하지 않습니다.

Redshift.SyntaxError “COPY명령에 구문 오류가 포함되어 있습니다. 명령을 다시 시도하십시오."
Redshift.AuthenticationFailed "입력하신 사용자 이름과 암호가 인증에 실패했습니다. 유효한 사용자 이름 및 암호를 입력하십시오."
Redshift.AccessDenied "액세스가 거부되었습니다. 제공된 IAM 역할에 대한 신뢰 정책에서 Amazon Data Firehose가 역할을 수임하도록 허용하는지 확인합니다.”
Redshift.S3BucketAccessDenied “COPY명령이 S3 버킷에 액세스할 수 없습니다. 제공된 IAM 역할에 대한 액세스 정책이 S3 버킷에 대한 액세스를 허용하는지 확인합니다.'
Redshift.DataLoadFailed "테이블로 데이터를 로드하지 못했습니다. 자세한 내용은 STL_LOAD_ERRORS 시스템 테이블을 참조하세요.”
Redshift.ColumnNotFound “COPY명령의 열이 테이블에 존재하지 않습니다. 유효한 열 이름을 지정하십시오."
Redshift.DatabaseNotFound “Amazon Redshift 대상 구성에 지정된 데이터베이스를 찾을 JDBC URL 수 없습니다. 유효한 데이터베이스 이름을 지정하십시오."
Redshift.IncorrectCopyOptions

“분쟁 또는 중복 COPY 옵션이 제공되었습니다. 일부 옵션은 특정 조합에서 호환되지 않습니다. 자세한 내용은 COPY 명령 참조를 참조하세요.”

자세한 내용은 Amazon Redshift 데이터베이스 개발자 안내서의 Amazon Redshift COPY 명령을 참조하세요.

Redshift.MissingColumn “테이블 스키마에 DEFAULT 값이 NOT NULL 없고 열 목록에 포함되지 않은 열이 정의되어 있습니다. 이 열을 제외하고, 로드한 데이터가 항상 이 열에 대한 값을 제공하는지 확인하거나 이 테이블에 대한 Amazon Redshift 스키마에 기본 값을 추가하세요."
Redshift.ConnectionFailed "지정된 Amazon Redshift 클러스터에 연결하지 못했습니다. 보안 설정에서 Amazon Data Firehose 연결을 허용하고, Amazon Redshift 대상 구성에 지정된 클러스터 또는 데이터베이스가 JDBC URL 올바르고, 클러스터를 사용할 수 있는지 확인합니다.”
Redshift.ColumnMismatch “COPY명령의 jsonpath 수와 대상 테이블의 열 수가 일치해야 합니다. 명령을 다시 시도하십시오."
Redshift.IncorrectOrMissingRegion "Amazon Redshift가 S3 버킷에 액세스하기 위해 잘못된 리전 엔드포인트를 사용하려고 했습니다. COPY 명령 옵션에 올바른 리전 값을 지정하거나 S3 버킷이 Amazon Redshift 데이터베이스와 동일한 리전에 있는지 확인합니다.”
Redshift.IncorrectJsonPathsFile “제공된 jsonpaths 파일은 지원되는 JSON 형식이 아닙니다. 명령을 다시 시도하십시오."
Redshift.MissingS3File "Amazon Redshift가 요구한 하나 이상의 S3 파일이 S3 버킷에서 제거되었습니다. S3 버킷 정책을 확인하여 S3 파일의 자동 삭제를 제거하십시오."
Redshift.InsufficientPrivilege "사용자는 데이터를 테이블에 로드할 권한이 없습니다. INSERT 권한에 대한 Amazon Redshift 사용자 권한을 확인합니다.”
Redshift.ReadOnlyCluster "시스템이 크기 조정 모드에 있기 때문에 쿼리를 실행할 수 없습니다. 나중에 다시 쿼리를 시도하십시오."
Redshift.DiskFull "디스크가 가득 차 데이터를 로드할 수 없습니다. Amazon Redshift 클러스터의 용량을 늘리거나 사용하지 않는 데이터를 삭제해 디스크 공간을 확보하세요."
InternalError "데이터 전송을 시도하는 동안 내부 오류가 발생했습니다. 전송이 재시도됩니다. 오류가 지속되면 해결을 AWS 위해 에 보고됩니다.”
Redshift.ArgumentNotSupported “COPY명령에 지원되지 않는 옵션이 포함되어 있습니다.”
Redshift.AnalyzeTableAccessDenied “액세스가 거부되었습니다. 테이블 또는 데이터베이스 소유자만 테이블 분석을 수행할 수 있기 때문에 S3에서 Redshift로의 복사가 실패합니다.”
Redshift.SchemaNotFound “Amazon Redshift 대상 구성 DataTableName 의 에 지정된 스키마를 찾을 수 없습니다. 유효한 스키마 이름을 지정하세요.”
Redshift.ColumnSpecifiedMoreThanOnce “열 목록에 두 번 이상 지정된 열이 있습니다. 중복된 열은 제거해야 합니다.”
Redshift.ColumnNotNullWithoutDefault “열 목록에 포함되지 않은 null이 아닌 열이 DEFAULT 있습니다. 해당 열이 열 목록에 포함되어 있는지 확인하세요.”
Redshift.IncorrectBucketRegion “Redshift가 클러스터와 다른 리전에 있는 버킷을 사용하려고 시도했습니다. 클러스터와 같은 리전 내의 버킷을 지정하세요.”
Redshift.S3SlowDown “S3에 대한 높은 요청율. 전송률이 저하되지 않도록 속도를 낮추세요.”
Redshift.InvalidCopyOptionForJson “json 에 대해 자동 또는 유효한 S3 경로를 사용하십시오copyOption.”
Redshift.InvalidCopyOptionJSONPathFormat “COPY 형식이 유효하지 않습니다JSONPath. 배열 인덱스가 범위를 벗어났습니다\”. JSONPath 표현식을 수정하세요.”
Redshift.InvalidCopyOptionRBACAclNotAllowed “권한 전파가 활성화되지 않은 동안에는 acl 프레임워크RBAC를 사용할 수 없습니다.” 오류와 함께COPY 실패했습니다.
Redshift.DiskSpaceQuotaExceeded “디스크 공간 할당량 초과로 인해 트랜잭션이 중단되었습니다. 디스크 공간을 확보하거나 스키마의 할당량 증가를 요청하세요.”
Redshift.ConnectionsLimitExceeded “사용자에 대한 연결 제한이 초과되었습니다.”
Redshift.SslNotSupported “서버가 를 지원하지 않아 지정된 Amazon Redshift 클러스터에 연결하지 못했습니다SSL. 클러스터 설정을 확인하세요.”
Redshift.HoseNotFound “호스가 삭제되었습니다. 호스의 상태를 확인하세요.”
Redshift.Delimiter “의 copyOptions 구분 기호 copyCommand 가 유효하지 않습니다. 단일 문자여자 합니다.”
Redshift.QueryCancelled “사용자가 COPY 작업을 취소했습니다.”
Redshift.CompressionMismatch “호스는 로 구성UNCOMPRESSED되지만 압축 형식을 copyOption 포함합니다.”
Redshift.EncryptionCredentials “ENCRYPTED옵션에는 'aws_iam_role=...;master_symmetric_key=...' 또는 'aws_access_key_id=...;aws_secret_access_key=...[;token=...];master_symmetric_key=...' 형식의 보안 인증 정보가 필요합니다.”
Redshift.InvalidCopyOptions “잘못된 COPY 구성 옵션”
Redshift.InvalidMessageFormat “COPY 명령에 잘못된 문자가 있습니다.”
Redshift.TransactionIdLimitReached “거래 ID 한도에 도달했습니다.”
Redshift.DestinationRemoved “redshift 대상이 존재하고 Firehose 구성에 올바르게 설정되어 있는지 확인하세요.”
Redshift.OutOfMemory “Redshift 클러스터에 메모리가 부족합니다. 클러스터의 용량이 충분한지 확인하세요.”
Redshift.CannotForkProcess “Redshift 클러스터에 메모리가 부족합니다. 클러스터의 용량이 충분한지 확인하세요.”
Redshift.SslFailure “핸드셰이크 중에 SSL 연결이 닫혔습니다.”
Redshift.Resize “Redshift 클러스터의 크기가 조정되고 있습니다. 클러스터 크기가 조정되는 동안에는 Firehose가 데이터를 전송할 수 없습니다.”
Redshift.ImproperQualifiedName “인증된 이름이 적절하지 않습니다(점 표시 이름이 너무 많음).”
Redshift.InvalidJsonPathFormat “잘못된 JSONPath 형식”
Redshift.TooManyConnectionsException “Redshift에 대한 연결이 너무 많습니다.”
Redshift.PSQLException “Redshift에서PSQlException 관찰됨.”
Redshift.DuplicateSecondsSpecification “날짜/시간 형식의 초 지정이 중복되었습니다.”
Redshift.RelationCouldNotBeOpened “Redshift 오류가 발생했습니다. 관계를 열 수 없습니다. 지정된 DB에 대한 Redshift 로그를 확인하세요.”
Redshift.TooManyClients “Redshift에서 너무 많은 클라이언트 예외가 발생했습니다. 여러 명의 생산자가 동시에 데이터베이스에 데이터를 쓰는 경우 데이터베이스에 대한 최대 연결 수를 다시 확인하세요.”

Snowflake 데이터 전송 오류

Firehose는 다음과 같은 Snowflake 관련 오류를 CloudWatch 로그로 전송할 수 있습니다.

오류 코드 오류 메시지와 정보
Snowflake.InvalidUrl

“Firehose는 Snowflake에 연결할 수 없습니다. Snowflake 대상 구성에서 계정 URL이 올바르게 지정되었는지 확인하세요.”

Snowflake.InvalidUser

“Firehose는 Snowflake에 연결할 수 없습니다. Snowflake 대상 구성에서 사용자가 올바르게 지정되었는지 확인하세요.”

Snowflake.InvalidRole

“지정된 snowflake 역할이 존재하지 않거나 권한이 없습니다. 지정된 사용자에게 역할이 부여되었는지 확인하세요.”

Snowflake.InvalidTable

“제공된 테이블이 존재하지 않거나 승인되지 않았습니다.”

Snowflake.InvalidSchema

“제공된 스키마가 존재하지 않거나 권한이 없습니다.”

Snowflake.InvalidDatabase

“제공된 데이터베이스가 존재하지 않거나 권한이 없습니다.”

Snowflake.InvalidPrivateKeyOrPassphrase

“지정된 프라이빗 키 또는 암호가 유효하지 않습니다. 제공된 프라이빗 키는 유효한 PEM RSA 프라이빗 키여야 합니다.”

Snowflake.MissingColumns

“입력 페이로드의 열이 누락되어 삽입 요청이 거부되었습니다. nullable이 아닌 모든 열에 대해 값이 지정되어 있는지 확인합니다.”

Snowflake.ExtraColumns

“추가 열로 인해 삽입 요청이 거부되었습니다. 테이블에 없는 열은 지정하면 안 됩니다.”

Snowflake.InvalidInput

“잘못된 입력 형식으로 인해 전송에 실패했습니다. 제공된 입력 페이로드가 허용 가능한 JSON 형식인지 확인합니다.”

Snowflake.IncorrectValue

“입력 페이로드의 잘못된 데이터 유형으로 인해 전송에 실패했습니다. 입력 페이로드에 지정된 JSON 값이 Snowflake 테이블 정의에 선언된 데이터 유형을 준수하는지 확인합니다.”

Splunk 데이터 전송 오류

Amazon Data Firehose는 다음과 같은 Splunk 관련 오류를 CloudWatch Logs로 전송할 수 있습니다.

오류 코드 오류 메시지와 정보
Splunk.ProxyWithoutStickySessions

“Amazon Data Firehose와 HEC 노드 사이에 프록시(ELB 또는 기타)가 있는 경우 를 지원하도록 고정 세션을 활성화해야 합니다HECACKs.”

Splunk.DisabledToken “토HEC큰이 비활성화되었습니다. Splunk로의 데이터 전송을 허용하려면 이 토큰을 활성화하십시오."
Splunk.InvalidToken “토HEC큰이 유효하지 않습니다. 유효한 HEC 토큰으로 Amazon Data Firehose를 업데이트합니다.”
Splunk.InvalidDataFormat "데이터의 형식이 올바르지 않습니다. 원시 또는 이벤트 HEC 엔드포인트의 데이터를 올바르게 포맷하는 방법은 Splunk 이벤트 데이터 단원을 참조하세요.
Splunk.InvalidIndex “토HEC큰 또는 입력이 잘못된 인덱스로 구성되어 있습니다. 인덱스 구성을 확인한 후 다시 시도하십시오."
Splunk.ServerError “HEC노드의 서버 오류로 인해 Splunk로 데이터를 전송하지 못했습니다. Amazon Data Firehose의 재시도 기간이 0보다 큰 경우 Amazon Data Firehose는 데이터 전송을 재시도합니다. 모든 재시도가 실패하면 Amazon Data Firehose는 데이터를 Amazon S3에 백업합니다.'
Splunk.DisabledAck “HEC토큰에 대해 인덱서 승인이 비활성화되었습니다. 인덱서 확인을 활성화하고 다시 시도하십시오. 자세한 정보는 Enable indexer acknowledgement를 참조하십시오."
Splunk.AckTimeout “확인 제한 시간이 만료HEC되기 전에 에서 HEC 확인을 받지 못했습니다. 확인 제한 시간에도 불구하고, Splunk에서 데이터를 올바로 인덱싱할 수 있었습니다. Amazon Data Firehose는 확인 제한 시간이 만료된 Amazon S3 데이터에 백업합니다.'
Splunk.MaxRetriesFailed

"Splunk로의 데이터 전송 또는 확인 수신에 실패했습니다. HEC 상태를 확인하고 다시 시도하세요.”

Splunk.ConnectionTimeout "Splunk 연결 시간을 초과했습니다. 이는 일시적인 오류일 수 있으며 요청이 재시도됩니다. Amazon Data Firehose는 모든 재시도가 실패할 경우 Amazon S3에 데이터를 백업합니다.”
Splunk.InvalidEndpoint “엔드HEC포인트에 연결할 수 없습니다. HEC 엔드포인트URL가 유효하고 Amazon Data Firehose에서 연결할 수 있는지 확인합니다.”
Splunk.ConnectionClosed "연결 실패로 인해 Splunk에 데이터를 전송할 수 없습니다. 일시적 오류일 수 있습니다. Amazon Data Firehose 구성에서 재시도 기간을 늘리면 이러한 일시적인 실패를 방지할 수 있습니다.'
Splunk.SSLUnverified “엔드HEC포인트에 연결할 수 없습니다. 호스트가 피어에 의해 제공된 인증서와 일치하지 않습니다. 인증서와 호스트가 유효한지 확인하십시오."
Splunk.SSLHandshake “엔드HEC포인트에 연결할 수 없습니다. 인증서와 호스트가 유효한지 확인하십시오."
Splunk.URLNotFound “요청된 를 Splunk 서버에서 찾을 수 URL 없습니다. Splunk 클러스터가 올바르게 구성되었는지 확인하세요.”
Splunk.ServerError.ContentTooLarge “statusCode: 413, 메시지: 클라이언트가 보낸 요청이 너무 큼으로 서버 오류로 인해 Splunk로 데이터를 전송하지 못했습니다. max_content_length 설정은 Splunk 문서를 참조하세요.”
Splunk.IndexerBusy “HEC노드의 서버 오류로 인해 Splunk로 데이터를 전송하지 못했습니다. HEC 엔드포인트 또는 Elastic Load Balancer에 연결할 수 있고 정상 상태인지 확인합니다.”
Splunk.ConnectionRecycled “Firehose와 Splunk의 연결이 다시 순환되었습니다. 전송을 다시 시도합니다.”
Splunk.AcknowledgementsDisabled “에 대한 확인을 받을 수 없습니다POST. HEC 엔드포인트에서 확인이 활성화되어 있는지 확인합니다.'
Splunk.InvalidHecResponseCharacter “HEC응답에서 잘못된 문자를 찾았습니다. 서비스 및 HEC 구성을 확인하세요.”

ElasticSearch 데이터 전송 오류

Amazon Data Firehose는 다음 ElasticSearch 오류를 CloudWatch 로그로 전송할 수 있습니다.

오류 코드 오류 메시지와 정보
ES.AccessDenied "액세스가 거부되었습니다. Firehose와 연결된 제공된 IAM 역할이 삭제되지 않았는지 확인합니다.”
ES.ResourceNotFound “지정된 AWS Elasticsearch 도메인이 존재하지 않습니다.”

HTTPS 엔드포인트 데이터 전송 오류

Amazon Data Firehose는 다음과 같은 HTTP 엔드포인트 관련 오류를 CloudWatch 로그로 전송할 수 있습니다. 이 오류 중에 현재 발생한 문제와 일치하는 오류가 없는 경우 기본 오류는 다음과 같습니다: “데이터 전송을 시도하는 동안 내부 오류가 발생했습니다. 전송이 재시도됩니다. 오류가 지속되면 해결을 AWS 위해 에 보고됩니다.”

오류 코드 오류 메시지와 정보
HttpEndpoint.RequestTimeout

응답을 받기 전에 전송 시간이 초과되었으므로 다시 시도됩니다. 이 오류가 지속되면 AWS Firehose 서비스 팀에 문의하세요.

HttpEndpoint.ResponseTooLarge “엔드포인트에서 수신한 응답이 너무 큽니다. 엔드포인트 소유자에게 문의하여 이 문제를 해결하세요.”
HttpEndpoint.InvalidResponseFromDestination “지정된 엔드포인트에서 받은 응답이 유효하지 않습니다. 엔드포인트 소유자에게 문의하여 이 문제를 해결하세요.”
HttpEndpoint.DestinationException “엔드포인트 대상으로부터 다음 응답을 수신했습니다.”
HttpEndpoint.ConnectionFailed “대상 엔드포인트에 연결할 수 없습니다. 엔드포인트 소유자에게 문의하여 이 문제를 해결하세요.”
HttpEndpoint.ConnectionReset “엔드포인트와의 연결을 유지할 수 없습니다. 엔드포인트 소유자에게 문의하여 이 문제를 해결하세요.”
HttpEndpoint.ConnectionReset “엔드포인트와의 연결을 유지하는 데 문제가 있습니다. 엔드드포인트 소유자에게 문의하세요.”
HttpEndpoint.ResponseReasonPhraseExceededLimit “엔드포인트에서 수신한 응답 이유 문구가 구성된 제한인 64자를 초과했습니다.”
HttpEndpoint.InvalidResponseFromDestination “엔드포인트에서 받은 응답이 유효하지 않습니다. 자세한 내용은 Firehose 설명서의 HTTP 엔드포인트 문제 해결을 참조하세요. 원인: “
HttpEndpoint.DestinationException “엔드포인트로의 전송에 실패했습니다. 자세한 내용은 Firehose 설명서의 HTTP 엔드포인트 문제 해결을 참조하세요. 상태 코드와 함께 응답을 수신함 ”
HttpEndpoint.InvalidStatusCode “잘못된 응답 상태 코드를 수신했습니다.”
HttpEndpoint.SSLHandshakeFailure “엔드포인트로 SSL 핸드셰이크를 완료할 수 없습니다. 엔드포인트 소유자에게 문의하여 이 문제를 해결하세요.”
HttpEndpoint.SSLHandshakeFailure “엔드포인트로 SSL 핸드셰이크를 완료할 수 없습니다. 엔드포인트 소유자에게 문의하여 이 문제를 해결하세요.”
HttpEndpoint.SSLFailure “엔드포인트로 TLS 핸드셰이크를 완료할 수 없습니다. 엔드포인트 소유자에게 문의하여 이 문제를 해결하세요.”
HttpEndpoint.SSLHandshakeCertificatePathFailure “잘못된 인증 경로로 인해 엔드포인트로 SSL 핸드셰이크를 완료할 수 없습니다. 엔드포인트 소유자에게 문의하여 이 문제를 해결하세요.”
HttpEndpoint.SSLHandshakeCertificatePathValidationFailure “인증 경로 검증 실패로 인해 엔드포인트로 SSL 핸드셰이크를 완료할 수 없습니다. 엔드포인트 소유자에게 문의하여 이 문제를 해결하세요.”
HttpEndpoint.MakeRequestFailure.IllegalUriException '의 잘못된 입력으로 인해 HttpEndpoint 요청이 실패했습니다URI. 입력의 모든 문자URI가 유효한지 확인하세요.”
HttpEndpoint.MakeRequestFailure.IllegalCharacterInHeaderValue “잘못된 응답 오류로 인해 HttpEndpoint 요청이 실패했습니다. 헤더 값에 잘못된 '\n' 문자가 있습니다.”
HttpEndpoint.IllegalResponseFailure “잘못된 응답 오류로 인해 HttpEndpoint 요청이 실패했습니다. HTTP 메시지에는 콘텐츠 유형 헤더가 두 개 이상 포함되어서는 안 됩니다.”
HttpEndpoint.IllegalMessageStart “잘못된 응답 오류로 인해 HttpEndpoint 요청이 실패했습니다. 잘못된 HTTP 메시지 시작입니다. 자세한 내용은 Firehose 설명서의 HTTP 엔드포인트 문제 해결을 참조하세요.”

Amazon OpenSearch Service Data 전송 오류

OpenSearch 서비스 대상의 경우 Amazon Data Firehose는 OpenSearch 서비스에서 반환되는 오류를 CloudWatch 로그로 보냅니다.

OpenSearch 클러스터에서 반환될 수 있는 오류 외에도 다음과 같은 두 가지 오류가 발생할 수 있습니다.

  • Authentication/authorization error occurs during attempt to deliver data to destination OpenSearch Service cluster. This can happen due to any permission issues and/or Amazon Data Firehose 대상 OpenSearch 서비스 도메인 구성이 수정될 때 간헐적으로. 클러스터 정책 및 역할 권한을 확인하세요.

  • Amazon Data Firehose 대상 OpenSearch 서비스 도메인 구성이 수정될 때 authentication/authorization failures. This can happen due to any permission issues and/or 간헐적으로 인해 대상 OpenSearch 서비스 클러스터로 데이터를 전송할 수 없습니다. 클러스터 정책 및 역할 권한을 확인하세요.

오류 코드 오류 메시지와 정보
OS.AccessDenied "액세스가 거부되었습니다. 제공된 IAM 역할에 대한 신뢰 정책이 Firehose가 역할을 수임하도록 허용하고 액세스 정책이 Amazon OpenSearch Service에 대한 액세스를 허용하는지 확인합니다API.
OS.AccessDenied "액세스가 거부되었습니다. 제공된 IAM 역할에 대한 신뢰 정책이 Firehose가 역할을 수임하도록 허용하고 액세스 정책이 Amazon OpenSearch Service에 대한 액세스를 허용하는지 확인합니다API.
OS.AccessDenied "액세스가 거부되었습니다. Firehose와 연결된 제공된 IAM 역할이 삭제되지 않았는지 확인합니다.”
OS.AccessDenied "액세스가 거부되었습니다. Firehose와 연결된 제공된 IAM 역할이 삭제되지 않았는지 확인합니다.”
OS.ResourceNotFound “지정된 Amazon OpenSearch Service 도메인이 존재하지 않습니다.”
OS.ResourceNotFound “지정된 Amazon OpenSearch Service 도메인이 존재하지 않습니다.”
OS.AccessDenied "액세스가 거부되었습니다. 제공된 IAM 역할에 대한 신뢰 정책이 Firehose가 역할을 수임하도록 허용하고 액세스 정책이 Amazon OpenSearch Service에 대한 액세스를 허용하는지 확인합니다API.
OS.RequestTimeout “Amazon OpenSearch Service 클러스터 또는 OpenSearch Serverless 컬렉션에 대한 요청이 시간 초과되었습니다. 클러스터 또는 컬렉션에 현재 워크로드에 필요한 용량이 충분한지 확인하세요.”
OS.ClusterError “Amazon OpenSearch Service 클러스터가 지정되지 않은 오류를 반환했습니다.”
OS.RequestTimeout “Amazon OpenSearch Service 클러스터에 대한 요청이 시간 초과되었습니다. 클러스터에 현재 워크로드에 필요한 용량이 충분한지 확인하세요.”
OS.ConnectionFailed “Amazon OpenSearch Service 클러스터 또는 OpenSearch Serverless 컬렉션에 연결하는 데 문제가 있습니다. 클러스터 또는 컬렉션이 정상 상태이고 연결 가능한지 확인하세요.”
OS.ConnectionReset “Amazon OpenSearch Service 클러스터 또는 OpenSearch Serverless 컬렉션과의 연결을 유지할 수 없습니다. 클러스터 또는 컬렉션 소유자에게 문의하여 이 문제를 해결하세요.”
OS.ConnectionReset “Amazon OpenSearch Service 클러스터 또는 OpenSearch Serverless 컬렉션과의 연결을 유지하는 데 문제가 있습니다. 클러스터 또는 컬렉션이 정상 상태이고 현재 워크로드에 필요한 용량이 충분한지 확인하세요.”
OS.ConnectionReset “Amazon OpenSearch Service 클러스터 또는 OpenSearch Serverless 컬렉션과의 연결을 유지하는 데 문제가 있습니다. 클러스터 또는 컬렉션이 정상 상태이고 현재 워크로드에 필요한 용량이 충분한지 확인하세요.”
OS.AccessDenied "액세스가 거부되었습니다. Amazon OpenSearch Service 클러스터의 액세스 정책이 구성된 IAM 역할에 대한 액세스 권한을 부여하는지 확인합니다.'
OS.ValidationException “ OpenSearch 클러스터가 를 반환했습니다ESServiceException. 그 이유 중 하나는 클러스터가 OS 2.x 이상으로 업그레이드되었지만 호스에 여전히 TypeName 파라미터가 구성되어 있기 때문입니다. 를 빈 문자열 TypeName 로 설정하여 호스 구성을 업데이트하거나 엔드포인트를 유형 파라미터를 지원하는 클러스터로 변경합니다.'
OS.ValidationException “구성원은 다음 정규 표현식 패턴을 충족해야 합니다: [a-z][a-z0-9\\ -]+
OS.JsonParseException “Amazon OpenSearch Service 클러스터가 를 반환했습니다 JsonParseException. 입력되는 데이터가 유효한지 확인하세요.”
OS.AmazonOpenSearchServiceParseException “Amazon OpenSearch Service 클러스터가 를 반환했습니다 AmazonOpenSearchServiceParseException. 입력되는 데이터가 유효한지 확인하세요.”
OS.ExplicitIndexInBulkNotAllowed “Amazon OpenSearch Service 클러스터에서 rest.action.multi.allow_explicit_index가 true로 설정되어 있습니다.”
OS.ClusterError “Amazon OpenSearch Service 클러스터 또는 OpenSearch Serverless 컬렉션에서 지정되지 않은 오류를 반환했습니다.”
OS.ClusterBlockException “클러스터가 를 반환했습니다 ClusterBlockException. 과부하가 발생했을 수 있습니다.”
OS.InvalidARN “ARN제공된 Amazon OpenSearch 서비스가 유효하지 않습니다. DeliveryStream 구성을 확인하세요.”
OS.MalformedData “하나 이상의 레코드 형식이 잘못되었습니다. 각 레코드가 유효한 단일 JSON 객체이고 새 줄이 포함되어 있지 않은지 확인하세요.”
OS.InternalError "데이터 전송을 시도하는 동안 내부 오류가 발생했습니다. 전송이 재시도됩니다. 오류가 지속되면 해결을 AWS 위해 에 보고됩니다.”
OS.AliasWithMultipleIndicesNotAllowed “별칭에 연결된 인덱스가 두 개 이상 있습니다. 별칭에 연결된 인덱스는 하나만 있어야 합니다.”
OS.UnsupportedVersion “Amazon OpenSearch Service 6.0은 현재 Amazon Data Firehose에서 지원되지 않습니다. 자세한 내용은 AWS 지원 팀에 문의하세요.”
OS.CharConversionException “하나 이상의 레코드에 잘못된 문자가 포함되어 있습니다.”
OS.InvalidDomainNameLength “도메인 이름 길이가 유효한 OS 한도를 벗어났습니다.”
OS.VPCDomainNotSupported “내 Amazon OpenSearch Service 도메인VPCs은 현재 지원되지 않습니다.”
OS.ConnectionError “http 서버가 예기치 않게 연결을 종료했습니다. Amazon OpenSearch Service 클러스터 또는 OpenSearch Serverless 컬렉션의 상태를 확인하세요.”
OS.LargeFieldData “Amazon OpenSearch Service 클러스터가 허용된 것보다 큰 필드 데이터를 포함했으므로 요청을 중단했습니다.”
OS.BadGateway “Amazon OpenSearch Service 클러스터 또는 OpenSearch 서버리스 컬렉션이 502 Bad Gateway”라는 응답으로 요청을 중단했습니다.
OS.ServiceException “Amazon OpenSearch Service 클러스터 또는 OpenSearch Serverless 컬렉션에서 수신한 오류입니다. 클러스터 또는 컬렉션이 뒤에 있는 경우 네트워크 구성에서 연결을 허용하는VPC지 확인합니다.'
OS.GatewayTimeout “Amazon OpenSearch Service 클러스터 또는 OpenSearch Serverless 컬렉션에 연결할 때 Firehose에 제한 시간 오류가 발생했습니다.”
OS.MalformedData “Amazon Data Firehose는 Firehose 레코드 내에서 Amazon OpenSearch Service Bulk API 명령을 지원하지 않습니다.”
OS.ResponseEntryCountMismatch “벌크의 응답에 전송된 레코드 수보다 많은 항목이 API 포함되어 있습니다. 각 레코드에 JSON 객체가 하나만 포함되어 있고 새 줄이 없는지 확인합니다.”

Lambda 호출 오류

Amazon Data Firehose는 다음과 같은 Lambda 호출 오류를 CloudWatch 로그로 전송할 수 있습니다.

오류 코드 오류 메시지와 정보
Lambda.AssumeRoleAccessDenied

"액세스가 거부되었습니다. 제공된 IAM 역할에 대한 신뢰 정책에서 Amazon Data Firehose가 역할을 수임할 수 있도록 허용하는지 확인합니다.”

Lambda.InvokeAccessDenied

"액세스가 거부되었습니다. 액세스 정책이 Lambda 함수에 대한 액세스를 허용해야 합니다."

Lambda.JsonProcessingException

"Lambda 함수에서 반환한 레코드를 구문 분석하는 중 오류가 발생했습니다. 반환된 레코드가 Amazon Data Firehose에서 요구하는 상태 모델을 따르는지 확인합니다.”

자세한 내용은 데이터 변환에 필요한 파라미터 단원을 참조하십시오.

Lambda.InvokeLimitExceeded

"Lambda 동시 실행 한도를 초과했습니다. 동시 실행 한도를 늘리십시오."

자세한 정보는 AWS Lambda 개발자 안내서AWS Lambda 제한을 참조하세요.

Lambda.DuplicatedRecordId

"동일한 레코드 ID로 여러 레코드가 반환되었습니다. Lambda 함수가 각 레코드에 IDs 대해 고유한 레코드를 반환하는지 확인합니다.'

자세한 내용은 데이터 변환에 필요한 파라미터 단원을 참조하십시오.

Lambda.MissingRecordId

“하나 이상의 레코드IDs가 반환되지 않았습니다. Lambda 함수가 수신된 모든 레코드를 반환하는지 확인합니다IDs.

자세한 내용은 데이터 변환에 필요한 파라미터 단원을 참조하십시오.

Lambda.ResourceNotFound

"지정된 Lambda 함수가 존재하지 않습니다. 다른 기존 함수를 사용하십시오."

Lambda.InvalidSubnetIDException

“Lambda 함수 VPC 구성에서 지정된 서브넷 ID가 유효하지 않습니다. 서브넷 ID가 유효한지 확인하십시오."

Lambda.InvalidSecurityGroupIDException

“Lambda 함수 VPC 구성에서 지정된 보안 그룹 ID가 유효하지 않습니다. 보안 그룹 ID가 유효한지 확인하십시오."

Lambda.SubnetIPAddressLimitReachedException

“구성AWS Lambda 된 서브넷 중 하나 이상에 사용 가능한 IP 주소가 없어 Lambda 함수에 대한 VPC 액세스를 설정할 수 없었습니다. IP 주소 제한을 늘리십시오."

자세한 내용은 Amazon 사용 설명서의 Amazon VPC 제한 VPC 및 서브넷을 참조하세요. VPC

Lambda.ENILimitReachedException

“네트워크 인터페이스에 대한 제한에 도달했으므로 Lambda 함수 구성의 일부로 VPC지정된 에서 탄력적 네트워크 인터페이스(ENI)를 생성할 수AWS Lambda 없었습니다. 네트워크 인터페이스 제한을 늘리십시오."

자세한 내용은 Amazon 사용 설명서의 Amazon VPC 제한 - 네트워크 인터페이스를 참조하세요. VPC

Lambda.FunctionTimedOut

Lambda 함수가 시간을 초과했습니다. Lambda 함수의 Timeout 설정을 늘리세요. 자세한 내용은 함수 제한 시간을 참조하세요.

Lambda.FunctionError

이는 다음 오류 중 하나로 인해 발생할 수 있습니다.

  • 잘못된 출력 구조. 함수를 확인하고 출력이 필수 형식인지 확인하세요. 또한 처리된 레코드에 Dropped, Ok 또는 ProcessingFailed의 유효한 결과 상태가 포함되어 있는지 확인하세요.

  • Lambda 함수가 성공적으로 호출되었지만 오류 결과를 반환했습니다.

  • Lambda는 KMS 액세스가 거부되어 환경 변수를 복호화할 수 없었습니다. 함수의 KMS 키 설정과 키 정책을 확인합니다. 자세한 내용은 키 액세스 문제 해결을 참조하세요.

Lambda.FunctionRequestTimedOut

Lambda를 호출할 때 요청 제한 시간 구성 오류 이전에 Amazon Data Firehose에 요청이 완료되지 않았습니다. Lambda 코드를 다시 방문하여 Lambda 코드가 구성된 제한 시간 이후에 실행되어야 하는지 확인합니다. 그런 경우, 메모리, 제한 시간을 포함한 Lambda 구성 설정의 조정을 고려하세요. 자세한 내용은 Lambda 함수 옵션 구성을 참조하세요.

Lambda.TargetServerFailedToRespond

Amazon Data Firehose에 오류가 발생했습니다. 대상 서버가 AWS Lambda 서비스를 호출할 때 오류에 응답하지 못했습니다.

Lambda.InvalidZipFileException

Lambda 함수를 호출할 때 Amazon Data Firehose가 발생했습니다 InvalidZipFileException. Lambda 함수 구성 설정 및 Lambda 코드 압축 파일을 확인하세요.

Lambda.InternalServerError

“ AWS Lambda 서비스를 호출할 때 Amazon Data Firehose가 발생했습니다 InternalServerError. Amazon Data Firehose는 고정된 횟수만큼 데이터 전송을 다시 시도합니다. CreateDeliveryStream 또는 UpdateDestination 를 사용하여 재시도 옵션을 지정하거나 재정의할 수 있습니다APIs. 오류가 지속되면 AWS Lambda 지원팀에 문의하세요.

Lambda.ServiceUnavailable

AWS Lambda 서비스를 호출할 ServiceUnavailableException 때 Amazon Data Firehose가 발생했습니다. Amazon Data Firehose는 고정된 횟수만큼 데이터 전송을 다시 시도합니다. CreateDeliveryStream 또는 UpdateDestination 를 사용하여 재시도 옵션을 지정하거나 재정의할 수 있습니다APIs. 오류가 지속되면 AWS Lambda 지원팀에 문의하세요.

Lambda.InvalidSecurityToken

잘못된 보안 토큰으로 인해 Lambda 함수를 호출할 수 없습니다. 파티션 간 Lambda 호출은 지원되지 않습니다.

Lambda.InvocationFailure

이는 다음 오류 중 하나로 인해 발생할 수 있습니다.

  • Amazon Data Firehose에서 AWS Lambda를 호출할 때 오류가 발생했습니다. 작업이 다시 시도됩니다. 오류가 지속될 경우 해결을 위해 AWS 에 보고됩니다."

  • Amazon Data Firehose가 LambdaKMSInvalidStateException에서 를 발견했습니다. 사용된 KMS 키가 복호화에 유효하지 않은 상태이므로 Lambda가 환경 변수를 복호화할 수 없었습니다. lambda 함수의 KMS 키를 확인합니다.

  • Amazon Data Firehose가 Lambda AWS LambdaException 에서 를 발견했습니다. Lambda가 제공된 컨테이너 이미지를 초기화하지 못했습니다. 이미지를 확인하세요.

  • AWS Lambda를 호출할 때 Amazon Data Firehose에서 제한 시간 오류가 발생했습니다. 지원되는 함수 제한 시간은 최대 5분입니다. 자세한 내용은 데이터 변환 실행 기간간을 참조하세요.

Lambda.JsonMappingException

Lambda 함수에서 반환한 레코드를 구문 분석하는 중 오류가 발생했습니다. 데이터 필드가 Base-64로 인코딩되었는지 확인하세요.

Kinesis 호출 오류

Amazon Data Firehose는 다음과 같은 Kinesis 호출 오류를 CloudWatch 로그로 전송할 수 있습니다.

오류 코드 오류 메시지와 정보
Kinesis.AccessDenied “Kinesis를 호출하는 동안 액세스가 거부되었습니다. 사용된 IAM 역할의 액세스 정책이 적절한 Kinesis 에 대한 액세스를 허용하는지 확인합니다APIs.”
Kinesis.ResourceNotFound “Firehose가 스트림에서 데이터를 읽지 못했습니다. Firehose가 Kinesis Stream에 연결되어 있는 경우 스트림이 존재하지 않거나 샤드가 병합 또는 분할되었을 수 있습니다. Firehose가 DirectPut 유형인 경우 Firehose가 더 이상 존재하지 않을 수 있습니다.”
Kinesis.SubscriptionRequired “Kinesis를 호출하는 동안 액세스가 거부되었습니다. Kinesis 스트림 액세스에 대해 전달된 IAM 역할에 AWS Kinesis 구독이 있는지 확인합니다.”
Kinesis.Throttling “Kinesis를 호출하는 동안 제한(Throttling)오류가 발생했습니다. 이는 Firehose 스트림APIs과 동일한 를 호출하는 다른 애플리케이션 또는 소스와 동일한 Kinesis 스트림으로 Firehose 스트림을 너무 많이 생성했기 때문일 수 있습니다.
Kinesis.Throttling “Kinesis를 호출하는 동안 제한(Throttling)오류가 발생했습니다. 이는 Firehose 스트림APIs과 동일한 를 호출하는 다른 애플리케이션 또는 소스와 동일한 Kinesis 스트림으로 Firehose 스트림을 너무 많이 생성했기 때문일 수 있습니다.
Kinesis.AccessDenied “Kinesis를 호출하는 동안 액세스가 거부되었습니다. 사용된 IAM 역할의 액세스 정책이 적절한 Kinesis 에 대한 액세스를 허용하는지 확인합니다APIs.”
Kinesis.AccessDenied 기본 Kinesis Stream에서 API 작업을 호출하려고 시도하는 동안 액세스가 거부되었습니다. IAM 역할이 전파되고 유효한지 확인합니다.”
Kinesis.KMS.AccessDeniedException “Firehose는 Kinesis Stream을 암호화/복호화하는 데 사용되는 KMS 키에 액세스할 수 없습니다. Firehose 전송 역할에 키에 대한 액세스 권한을 부여하세요.”
Kinesis.KMS.KeyDisabled “암호화/복호화에 사용되는 KMS 키가 비활성화되어 있기 때문에 Firehose는 소스 Kinesis Stream에서 읽을 수 없습니다. 읽기를 계속할 수 있도록 키를 활성화하세요.”
Kinesis.KMS.InvalidStateException “암호화에 사용되는 KMS 키가 잘못된 상태이므로 Firehose는 소스 Kinesis Stream에서 읽을 수 없습니다.”
Kinesis.KMS.NotFoundException “암호화에 사용된 KMS 키를 찾을 수 없으므로 소스 Kinesis Stream에서 Firehose를 읽을 수 없습니다.”

Kinesis DirectPut 호출 오류

Amazon Data Firehose는 다음과 같은 Kinesis DirectPut 호출 오류를 CloudWatch 로그로 전송할 수 있습니다.

오류 코드 오류 메시지와 정보
Firehose.KMS.AccessDeniedException “Firehose는 KMS 키에 액세스할 수 없습니다. 키 정책을 확인하세요.”
Firehose.KMS.InvalidStateException “Firehose는 데이터를 암호화하는 데 사용되는 KMS 키가 잘못된 상태이므로 데이터를 복호화할 수 없습니다.”
Firehose.KMS.NotFoundException “암호화에 사용된 KMS 키를 찾을 수 없으므로 Firehose가 데이터를 복호화할 수 없습니다.”
Firehose.KMS.KeyDisabled “Firehose는 데이터를 암호화하는 데 사용되는 KMS 키가 비활성화되어 있기 때문에 데이터를 복호화할 수 없습니다. 데이터 전송을 계속할 수 있도록 키를 활성화하세요.”

AWS Glue 호출 오류

Amazon Data Firehose는 다음과 같은 AWS Glue 호출 오류를 CloudWatch 로그로 전송할 수 있습니다.

오류 코드 오류 메시지와 정보
DataFormatConversion.InvalidSchema “스키마가 유효하지 않습니다.”
DataFormatConversion.EntityNotFound “지정된 가 table/database could not be found. Please ensure that the table/database 존재하며 스키마 구성에 제공된 값이 올바른지, 특히 케이싱과 관련됩니다.”
DataFormatConversion.InvalidInput “Glue에서 일치하는 스키마를 찾을 수 없습니다. 제공된 카탈로그 ID를 가진 지정된 데이터베이스가 존재하는지 확인하세요.”
DataFormatConversion.InvalidInput “Glue에서 일치하는 스키마를 찾을 수 없습니다. 전달된 가 올바른 형식ARN인지 확인하세요.”
DataFormatConversion.InvalidInput “Glue에서 일치하는 스키마를 찾을 수 없습니다. catalogId 제공된 이 유효한지 확인하세요.”
DataFormatConversion.InvalidVersionId “Glue에서 일치하는 스키마를 찾을 수 없습니다. 지정된 버전의 테이블이 존재하는지 확인하세요.”
DataFormatConversion.NonExistentColumns “Glue에서 일치하는 스키마를 찾을 수 없습니다. 테이블이 대상 열을 포함한, null이 아닌 스토리지 설명자로 구성되어 있는지 확인하세요.”
DataFormatConversion.AccessDenied “역할 수임 중 액세스가 거부되었습니다. 데이터 형식 변환 구성에 지정된 역할이 Firehose 서비스에 역할을 사용할 수 있는 권한을 부여했는지 확인하세요.”
DataFormatConversion.ThrottledByGlue “Glue를 호출하는 동안 제한(Throttling)오류가 발생했습니다. 요청 비율 제한을 늘리거나 다른 애플리케이션을 통해 Glue를 호출하는 현재 비율을 낮추세요.”
DataFormatConversion.AccessDenied “Glue를 호출하는 동안 액세스가 거부되었습니다. 데이터 형식 변환 구성에 지정된 역할에 필수 권한이 있는지 확인하세요.”
DataFormatConversion.InvalidGlueRole “잘못된 역할입니다. 데이터 형식 변환 구성에 지정된 역할이 존재하는지 확인하세요.”
DataFormatConversion.InvalidGlueRole “요청에 포함된 보안 토큰이 잘못되었습니다. Firehose와 연결된 제공된 IAM 역할이 삭제되지 않았는지 확인합니다.”
DataFormatConversion.GlueNotAvailableInRegion “지정한 리전에서AWS 아직Glue를 사용할 수 없습니다. 다른 리전을 지정하세요.”
DataFormatConversion.GlueEncryptionException “마스터 키를 검색하는 중 오류가 발생했습니다. 키가 존재하고 올바른 액세스 권한이 있는지 확인하세요.”
DataFormatConversion.SchemaValidationTimeout “Glue에서 테이블을 가져오는 중 시간이 초과되었습니다. Glue 테이블 버전이 많은 경우 'glue:GetTableVersion' 권한(권장)을 추가하거나 사용하지 않는 테이블 버전을 삭제하세요. Glue에 테이블이 많지 않은 경우 AWS 지원 팀에 문의하세요.”
DataFirehose.InternalError “Glue에서 테이블을 가져오는 중 시간이 초과되었습니다. Glue 테이블 버전이 많은 경우 'glue:GetTableVersion' 권한(권장)을 추가하거나 사용하지 않는 테이블 버전을 삭제하세요. Glue에 테이블이 많지 않은 경우 AWS 지원 팀에 문의하세요.”
DataFormatConversion.GlueEncryptionException “마스터 키를 검색하는 중 오류가 발생했습니다. 키가 존재하고 상태가 정상인지 확인하세요.”

DataFormatConversion 호출 오류

Amazon Data Firehose는 다음과 같은 DataFormatConversion 호출 오류를 CloudWatch 로그로 전송할 수 있습니다.

오류 코드 오류 메시지와 정보
DataFormatConversion.InvalidSchema “스키마가 유효하지 않습니다.”
DataFormatConversion.ValidationException “열 이름과 유형은 비어 있지 않은 문자열이어야 합니다.”
DataFormatConversion.ParseError “형식이 잘못됨JSON”
DataFormatConversion.MalformedData “데이터가 스키마와 일치하지 않습니다.”
DataFormatConversion.MalformedData “json 키의 길이는 262144를 초과할 수 없습니다.”
DataFormatConversion.MalformedData “데이터를 UTF-8로 디코딩할 수 없습니다.”
DataFormatConversion.MalformedData “토큰 사이에 잘못된 문자가 있습니다.”
DataFormatConversion.InvalidTypeFormat “잘못된 Type 형식입니다. Type 구문을 확인하세요.”
DataFormatConversion.InvalidSchema “잘못된 스키마입니다. 열 이름에 특수 문자나 공백이 없어야 합니다.”
DataFormatConversion.InvalidRecord “레코드가 스키마와 다릅니다. 맵<스트링,문자열>에 대해 하나 이상의 맵 키가 유효하지 않습니다.”
DataFormatConversion.MalformedData “입력에 최상위 수준의 프리미티브가 JSON 포함되어 있습니다. 최상위 레벨은 객체 또는 배열이어야 합니다.”
DataFormatConversion.MalformedData “입력에 최상위 수준의 프리미티브가 JSON 포함되어 있습니다. 최상위 레벨은 객체 또는 배열이어야 합니다.”
DataFormatConversion.MalformedData “레코드가 비어 있거나 공백만 포함되어 있습니다.”
DataFormatConversion.MalformedData “잘못된 문자입니다.”
DataFormatConversion.MalformedData “유효하지 않거나 지원되지 않는 타임스탬프 형식입니다. 지원되는 타임스탬프 형식은 Firehose 개발자 가이드를 참조하세요.”
DataFormatConversion.MalformedData “데이터에서 스칼라 유형을 찾았지만 스키마에 복합 유형이 지정되었습니다.”
DataFormatConversion.MalformedData “데이터가 스키마와 일치하지 않습니다.”
DataFormatConversion.MalformedData “데이터에서 스칼라 유형을 찾았지만 스키마에 복합 유형이 지정되었습니다.”
DataFormatConversion.ConversionFailureException "ConversionFailureException"
DataFormatConversion.DataFormatConversionCustomerErrorException "DataFormatConversionCustomerErrorException"
DataFormatConversion.DataFormatConversionCustomerErrorException "DataFormatConversionCustomerErrorException"
DataFormatConversion.MalformedData “데이터가 스키마와 일치하지 않습니다.”
DataFormatConversion.InvalidSchema “스키마가 유효하지 않습니다.”
DataFormatConversion.MalformedData “데이터가 스키마와 일치하지 않습니다. 하나 이상의 날짜의 형식이 잘못되었습니다.”
DataFormatConversion.MalformedData “데이터에는 지원되지 않는 고도로 중첩된 JSON 구조가 포함되어 있습니다.”
DataFormatConversion.EntityNotFound “지정된 가 table/database could not be found. Please ensure that the table/database 존재하며 스키마 구성에 제공된 값이 올바른지, 특히 케이싱과 관련됩니다.”
DataFormatConversion.InvalidInput “Glue에서 일치하는 스키마를 찾을 수 없습니다. 제공된 카탈로그 ID를 가진 지정된 데이터베이스가 존재하는지 확인하세요.”
DataFormatConversion.InvalidInput “Glue에서 일치하는 스키마를 찾을 수 없습니다. 전달된 가 올바른 형식ARN인지 확인하세요.”
DataFormatConversion.InvalidInput “Glue에서 일치하는 스키마를 찾을 수 없습니다. catalogId 제공된 이 유효한지 확인하세요.”
DataFormatConversion.InvalidVersionId “Glue에서 일치하는 스키마를 찾을 수 없습니다. 지정된 버전의 테이블이 존재하는지 확인하세요.”
DataFormatConversion.NonExistentColumns “Glue에서 일치하는 스키마를 찾을 수 없습니다. 테이블이 대상 열을 포함한, null이 아닌 스토리지 설명자로 구성되어 있는지 확인하세요.”
DataFormatConversion.AccessDenied “역할 수임 중 액세스가 거부되었습니다. 데이터 형식 변환 구성에 지정된 역할이 Firehose 서비스에 역할을 사용할 수 있는 권한을 부여했는지 확인하세요.”
DataFormatConversion.ThrottledByGlue “Glue를 호출하는 동안 제한(Throttling)오류가 발생했습니다. 요청 비율 제한을 늘리거나 다른 애플리케이션을 통해 Glue를 호출하는 현재 비율을 낮추세요.”
DataFormatConversion.AccessDenied “Glue를 호출하는 동안 액세스가 거부되었습니다. 데이터 형식 변환 구성에 지정된 역할에 필수 권한이 있는지 확인하세요.”
DataFormatConversion.InvalidGlueRole “잘못된 역할입니다. 데이터 형식 변환 구성에 지정된 역할이 존재하는지 확인하세요.”
DataFormatConversion.GlueNotAvailableInRegion “지정한 리전에서AWS 아직Glue를 사용할 수 없습니다. 다른 리전을 지정하세요.”
DataFormatConversion.GlueEncryptionException “마스터 키를 검색하는 중 오류가 발생했습니다. 키가 존재하고 올바른 액세스 권한이 있는지 확인하세요.”
DataFormatConversion.SchemaValidationTimeout “Glue에서 테이블을 가져오는 중 시간이 초과되었습니다. Glue 테이블 버전이 많은 경우 'glue:GetTableVersion' 권한(권장)을 추가하거나 사용하지 않는 테이블 버전을 삭제하세요. Glue에 테이블이 많지 않은 경우 AWS 지원 팀에 문의하세요.”
DataFirehose.InternalError “Glue에서 테이블을 가져오는 중 시간이 초과되었습니다. Glue 테이블 버전이 많은 경우 'glue:GetTableVersion' 권한(권장)을 추가하거나 사용하지 않는 테이블 버전을 삭제하세요. Glue에 테이블이 많지 않은 경우 AWS 지원 팀에 문의하세요.”
DataFormatConversion.MalformedData “하나 이상의 필드 형식이 잘못되었습니다.”