Network.AWS.CloudWatchLogs.PutLogEvents

Uploads a batch of log events to the specified log stream.

You must include the sequence token obtained from the response of the previous call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams . If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken , both calls may be successful, or one may be rejected.

The batch of events must satisfy the following constraints:

• The maximum batch size is 1,048,576 bytes, and this size is calculated as the sum of all event messages in UTF-8, plus 26 bytes for each log event.
• None of the log events in the batch can be more than 2 hours in the future.
• None of the log events in the batch can be older than 14 days or the retention period of the log group.
• The log events in the batch must be in chronological ordered by their time stamp (the time the event occurred, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC).
• The maximum number of log events in a batch is 10,000.
• A batch of log events in a single request cannot span more than 24 hours. Otherwise, the operation fails.

Creating a Request

putLogEvents

Arguments

:: Text

pleLogGroupName

-> Text

pleLogStreamName

-> NonEmpty InputLogEvent

pleLogEvents

-> PutLogEvents

Creates a value of PutLogEvents with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• pleSequenceToken - The sequence token obtained from the response of the previous PutLogEvents call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams . If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken , both calls may be successful, or one may be rejected.
• pleLogGroupName - The name of the log group.
• pleLogStreamName - The name of the log stream.
• pleLogEvents - The log events.

data PutLogEvents

See: putLogEvents smart constructor.

Instances

Eq PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

(==) :: PutLogEvents -> PutLogEvents -> Bool

(/=) :: PutLogEvents -> PutLogEvents -> Bool

Data PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> PutLogEvents -> c PutLogEvents

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c PutLogEvents

toConstr :: PutLogEvents -> Constr

dataTypeOf :: PutLogEvents -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c PutLogEvents)

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c PutLogEvents)

gmapT :: (forall b. Data b => b -> b) -> PutLogEvents -> PutLogEvents

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> PutLogEvents -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> PutLogEvents -> r

gmapQ :: (forall d. Data d => d -> u) -> PutLogEvents -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> PutLogEvents -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> PutLogEvents -> m PutLogEvents

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> PutLogEvents -> m PutLogEvents

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> PutLogEvents -> m PutLogEvents

Read PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

readsPrec :: Int -> ReadS PutLogEvents

readList :: ReadS [PutLogEvents]

readPrec :: ReadPrec PutLogEvents

readListPrec :: ReadPrec [PutLogEvents]

Show PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

showsPrec :: Int -> PutLogEvents -> ShowS

show :: PutLogEvents -> String

showList :: [PutLogEvents] -> ShowS

Generic PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Associated Types

type Rep PutLogEvents :: Type -> Type

Methods

from :: PutLogEvents -> Rep PutLogEvents x

to :: Rep PutLogEvents x -> PutLogEvents

Hashable PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

hashWithSalt :: Int -> PutLogEvents -> Int

hash :: PutLogEvents -> Int

ToJSON PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

toJSON :: PutLogEvents -> Value

toEncoding :: PutLogEvents -> Encoding

toJSONList :: [PutLogEvents] -> Value

toEncodingList :: [PutLogEvents] -> Encoding

AWSRequest PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Associated Types

type Rs PutLogEvents :: Type

Methods

request :: PutLogEvents -> Request PutLogEvents

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy PutLogEvents -> ClientResponse -> m (Response PutLogEvents)

ToHeaders PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

toHeaders :: PutLogEvents -> [Header]

ToPath PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

toPath :: PutLogEvents -> ByteString

ToQuery PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

toQuery :: PutLogEvents -> QueryString

NFData PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

rnf :: PutLogEvents -> ()

type Rep PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

type Rep PutLogEvents = D1 (MetaData "PutLogEvents" "Network.AWS.CloudWatchLogs.PutLogEvents" "amazonka-cloudwatch-logs-1.6.1-3MDuvRaDmjeBjiAkGx8qXs" False) (C1 (MetaCons "PutLogEvents'" PrefixI True) ((S1 (MetaSel (Just "_pleSequenceToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_pleLogGroupName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) :*: (S1 (MetaSel (Just "_pleLogStreamName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :*: S1 (MetaSel (Just "_pleLogEvents") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (List1 InputLogEvent)))))

type Rs PutLogEvents

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

type Rs PutLogEvents = PutLogEventsResponse

Request Lenses

pleSequenceToken :: Lens' PutLogEvents (Maybe Text)

The sequence token obtained from the response of the previous PutLogEvents call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams . If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken , both calls may be successful, or one may be rejected.

pleLogGroupName :: Lens' PutLogEvents Text

The name of the log group.

pleLogStreamName :: Lens' PutLogEvents Text

The name of the log stream.

pleLogEvents :: Lens' PutLogEvents (NonEmpty InputLogEvent)

The log events.

Destructuring the Response

putLogEventsResponse

Arguments

:: Int

plersResponseStatus

-> PutLogEventsResponse

Creates a value of PutLogEventsResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• plersRejectedLogEventsInfo - The rejected events.
• plersNextSequenceToken - The next sequence token.
• plersResponseStatus - -- | The response status code.

data PutLogEventsResponse

See: putLogEventsResponse smart constructor.

Instances

Eq PutLogEventsResponse

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

(==) :: PutLogEventsResponse -> PutLogEventsResponse -> Bool

(/=) :: PutLogEventsResponse -> PutLogEventsResponse -> Bool

Data PutLogEventsResponse

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> PutLogEventsResponse -> c PutLogEventsResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c PutLogEventsResponse

toConstr :: PutLogEventsResponse -> Constr

dataTypeOf :: PutLogEventsResponse -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c PutLogEventsResponse)

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c PutLogEventsResponse)

gmapT :: (forall b. Data b => b -> b) -> PutLogEventsResponse -> PutLogEventsResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> PutLogEventsResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> PutLogEventsResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> PutLogEventsResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> PutLogEventsResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> PutLogEventsResponse -> m PutLogEventsResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> PutLogEventsResponse -> m PutLogEventsResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> PutLogEventsResponse -> m PutLogEventsResponse

Read PutLogEventsResponse

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

readsPrec :: Int -> ReadS PutLogEventsResponse

readList :: ReadS [PutLogEventsResponse]

readPrec :: ReadPrec PutLogEventsResponse

readListPrec :: ReadPrec [PutLogEventsResponse]

Show PutLogEventsResponse

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

showsPrec :: Int -> PutLogEventsResponse -> ShowS

show :: PutLogEventsResponse -> String

showList :: [PutLogEventsResponse] -> ShowS

Generic PutLogEventsResponse

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Associated Types

type Rep PutLogEventsResponse :: Type -> Type

Methods

from :: PutLogEventsResponse -> Rep PutLogEventsResponse x

to :: Rep PutLogEventsResponse x -> PutLogEventsResponse

NFData PutLogEventsResponse

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

Methods

rnf :: PutLogEventsResponse -> ()

type Rep PutLogEventsResponse

Defined in Network.AWS.CloudWatchLogs.PutLogEvents

type Rep PutLogEventsResponse = D1 (MetaData "PutLogEventsResponse" "Network.AWS.CloudWatchLogs.PutLogEvents" "amazonka-cloudwatch-logs-1.6.1-3MDuvRaDmjeBjiAkGx8qXs" False) (C1 (MetaCons "PutLogEventsResponse'" PrefixI True) (S1 (MetaSel (Just "_plersRejectedLogEventsInfo") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe RejectedLogEventsInfo)) :*: (S1 (MetaSel (Just "_plersNextSequenceToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_plersResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

plersRejectedLogEventsInfo :: Lens' PutLogEventsResponse (Maybe RejectedLogEventsInfo)

The rejected events.

plersNextSequenceToken :: Lens' PutLogEventsResponse (Maybe Text)

The next sequence token.

plersResponseStatus :: Lens' PutLogEventsResponse Int

• - | The response status code.