Network.AWS.CloudWatchLogs.PutLogEvents

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

Every PutLogEvents request must include the sequenceToken obtained from the response of the previous request. An upload in a newly created log stream does not require a sequenceToken. You can also get the sequenceToken using DescribeLogStreams.

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 timestamp.
• The maximum number of log events in a batch is 10,000.
• A batch of log events in a single PutLogEvents request cannot span more than 24 hours. Otherwise, the PutLogEvents operation will fail.

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
• pleLogGroupName
• pleLogStreamName
• pleLogEvents

data PutLogEvents

See: putLogEvents smart constructor.

Instances

Eq PutLogEvents

Methods

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

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

Data 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

Methods

readsPrec :: Int -> ReadS PutLogEvents

readList :: ReadS [PutLogEvents]

readPrec :: ReadPrec PutLogEvents

readListPrec :: ReadPrec [PutLogEvents]

Show PutLogEvents

Methods

showsPrec :: Int -> PutLogEvents -> ShowS

show :: PutLogEvents -> String

showList :: [PutLogEvents] -> ShowS

Generic PutLogEvents

Associated Types

type Rep PutLogEvents :: * -> *

Methods

from :: PutLogEvents -> Rep PutLogEvents x

to :: Rep PutLogEvents x -> PutLogEvents

Hashable PutLogEvents

Methods

hashWithSalt :: Int -> PutLogEvents -> Int

hash :: PutLogEvents -> Int

NFData PutLogEvents

Methods

rnf :: PutLogEvents -> ()

AWSRequest PutLogEvents

Associated Types

type Rs PutLogEvents :: *

Methods

request :: PutLogEvents -> Request PutLogEvents

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

ToPath PutLogEvents

Methods

toPath :: PutLogEvents -> ByteString

ToHeaders PutLogEvents

Methods

toHeaders :: PutLogEvents -> [Header]

ToQuery PutLogEvents

Methods

toQuery :: PutLogEvents -> QueryString

ToJSON PutLogEvents

Methods

toJSON :: PutLogEvents -> Value

toEncoding :: PutLogEvents -> Encoding

type Rep PutLogEvents

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

type Rs PutLogEvents

type Rs PutLogEvents = PutLogEventsResponse

Request Lenses

pleSequenceToken :: Lens' PutLogEvents (Maybe Text)

A string token that must be obtained from the response of the previous PutLogEvents request.

pleLogGroupName :: Lens' PutLogEvents Text

The name of the log group to put log events to.

pleLogStreamName :: Lens' PutLogEvents Text

The name of the log stream to put log events to.

pleLogEvents :: Lens' PutLogEvents (NonEmpty InputLogEvent)

Undocumented member.

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
• plersNextSequenceToken
• plersResponseStatus

data PutLogEventsResponse

See: putLogEventsResponse smart constructor.

Instances

Eq PutLogEventsResponse

Methods

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

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

Data PutLogEventsResponse

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

Methods

readsPrec :: Int -> ReadS PutLogEventsResponse

readList :: ReadS [PutLogEventsResponse]

readPrec :: ReadPrec PutLogEventsResponse

readListPrec :: ReadPrec [PutLogEventsResponse]

Show PutLogEventsResponse

Methods

showsPrec :: Int -> PutLogEventsResponse -> ShowS

show :: PutLogEventsResponse -> String

showList :: [PutLogEventsResponse] -> ShowS

Generic PutLogEventsResponse

Associated Types

type Rep PutLogEventsResponse :: * -> *

Methods

from :: PutLogEventsResponse -> Rep PutLogEventsResponse x

to :: Rep PutLogEventsResponse x -> PutLogEventsResponse

NFData PutLogEventsResponse

Methods

rnf :: PutLogEventsResponse -> ()

type Rep PutLogEventsResponse

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

Response Lenses

plersRejectedLogEventsInfo :: Lens' PutLogEventsResponse (Maybe RejectedLogEventsInfo)

Undocumented member.

plersNextSequenceToken :: Lens' PutLogEventsResponse (Maybe Text)

Undocumented member.

plersResponseStatus :: Lens' PutLogEventsResponse Int

The response status code.