amazonka-xray-1.4.5: Amazon X-Ray SDK.

Copyright(c) 2013-2016 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.XRay.GetTraceSummaries

Contents

Description

Retrieves IDs and metadata for traces available for a specified time frame using an optional filter. To get the full traces, pass the trace IDs to BatchGetTraces .

Synopsis

Creating a Request

getTraceSummaries #

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

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

  • gtsFilterExpression - Specify a filter expression to retrieve trace summaries for services or requests that meet certain requirements.
  • gtsNextToken - Specify the pagination token returned by a previous request to retrieve the next page of results.
  • gtsSampling - Set to true to get summaries for only a subset of available traces.
  • gtsStartTime - The start of the time frame for which to retrieve traces.
  • gtsEndTime - The end of the time frame for which to retrieve traces.

data GetTraceSummaries #

See: getTraceSummaries smart constructor.

Instances

Eq GetTraceSummaries # 
Data GetTraceSummaries # 

Methods

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

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

toConstr :: GetTraceSummaries -> Constr #

dataTypeOf :: GetTraceSummaries -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c GetTraceSummaries) #

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

gmapT :: (forall b. Data b => b -> b) -> GetTraceSummaries -> GetTraceSummaries #

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

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

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

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

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

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

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

Read GetTraceSummaries # 
Show GetTraceSummaries # 
Generic GetTraceSummaries # 
Hashable GetTraceSummaries # 
ToJSON GetTraceSummaries # 
NFData GetTraceSummaries # 

Methods

rnf :: GetTraceSummaries -> () #

AWSRequest GetTraceSummaries # 
ToQuery GetTraceSummaries # 
ToPath GetTraceSummaries # 
ToHeaders GetTraceSummaries # 
type Rep GetTraceSummaries # 
type Rep GetTraceSummaries = D1 (MetaData "GetTraceSummaries" "Network.AWS.XRay.GetTraceSummaries" "amazonka-xray-1.4.5-J4XKAMnL7sXGFCSrL2rXIE" False) (C1 (MetaCons "GetTraceSummaries'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_gtsFilterExpression") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_gtsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_gtsSampling") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))) ((:*:) (S1 (MetaSel (Just Symbol "_gtsStartTime") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 POSIX)) (S1 (MetaSel (Just Symbol "_gtsEndTime") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 POSIX))))))
type Rs GetTraceSummaries # 

Request Lenses

gtsFilterExpression :: Lens' GetTraceSummaries (Maybe Text) #

Specify a filter expression to retrieve trace summaries for services or requests that meet certain requirements.

gtsNextToken :: Lens' GetTraceSummaries (Maybe Text) #

Specify the pagination token returned by a previous request to retrieve the next page of results.

gtsSampling :: Lens' GetTraceSummaries (Maybe Bool) #

Set to true to get summaries for only a subset of available traces.

gtsStartTime :: Lens' GetTraceSummaries UTCTime #

The start of the time frame for which to retrieve traces.

gtsEndTime :: Lens' GetTraceSummaries UTCTime #

The end of the time frame for which to retrieve traces.

Destructuring the Response

getTraceSummariesResponse #

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

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

  • gtsrsTracesProcessedCount - The number of traces that were processed to get this set of summaries.
  • gtsrsNextToken - If the requested time frame contained more than one page of results, you can use this token to retrieve the next page. The first page contains the most most recent results, closest to the end of the time frame.
  • gtsrsApproximateTime - The start time of this page of results.
  • gtsrsTraceSummaries - Trace IDs and metadata for traces that were found in the specified time frame.
  • gtsrsResponseStatus - -- | The response status code.

data GetTraceSummariesResponse #

See: getTraceSummariesResponse smart constructor.

Instances

Eq GetTraceSummariesResponse # 
Data GetTraceSummariesResponse # 

Methods

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

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

toConstr :: GetTraceSummariesResponse -> Constr #

dataTypeOf :: GetTraceSummariesResponse -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c GetTraceSummariesResponse) #

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

gmapT :: (forall b. Data b => b -> b) -> GetTraceSummariesResponse -> GetTraceSummariesResponse #

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

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

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

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

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

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

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

Read GetTraceSummariesResponse # 
Show GetTraceSummariesResponse # 
Generic GetTraceSummariesResponse # 
NFData GetTraceSummariesResponse # 
type Rep GetTraceSummariesResponse # 
type Rep GetTraceSummariesResponse = D1 (MetaData "GetTraceSummariesResponse" "Network.AWS.XRay.GetTraceSummaries" "amazonka-xray-1.4.5-J4XKAMnL7sXGFCSrL2rXIE" False) (C1 (MetaCons "GetTraceSummariesResponse'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_gtsrsTracesProcessedCount") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Integer))) (S1 (MetaSel (Just Symbol "_gtsrsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_gtsrsApproximateTime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe POSIX))) ((:*:) (S1 (MetaSel (Just Symbol "_gtsrsTraceSummaries") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [TraceSummary]))) (S1 (MetaSel (Just Symbol "_gtsrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int))))))

Response Lenses

gtsrsTracesProcessedCount :: Lens' GetTraceSummariesResponse (Maybe Integer) #

The number of traces that were processed to get this set of summaries.

gtsrsNextToken :: Lens' GetTraceSummariesResponse (Maybe Text) #

If the requested time frame contained more than one page of results, you can use this token to retrieve the next page. The first page contains the most most recent results, closest to the end of the time frame.

gtsrsApproximateTime :: Lens' GetTraceSummariesResponse (Maybe UTCTime) #

The start time of this page of results.

gtsrsTraceSummaries :: Lens' GetTraceSummariesResponse [TraceSummary] #

Trace IDs and metadata for traces that were found in the specified time frame.

gtsrsResponseStatus :: Lens' GetTraceSummariesResponse Int #

  • - | The response status code.