ApplicationInsights / Client / create_log_pattern

create_log_pattern#

ApplicationInsights.Client.create_log_pattern(**kwargs)#

Adds an log pattern to a LogPatternSet.

See also: AWS API Documentation

Request Syntax

response = client.create_log_pattern(
    ResourceGroupName='string',
    PatternSetName='string',
    PatternName='string',
    Pattern='string',
    Rank=123
)
Parameters:

  • ResourceGroupName (string) –

    [REQUIRED]

    The name of the resource group.

  • PatternSetName (string) –

    [REQUIRED]

    The name of the log pattern set.

  • PatternName (string) –

    [REQUIRED]

    The name of the log pattern.

  • Pattern (string) –

    [REQUIRED]

    The log pattern. The pattern must be DFA compatible. Patterns that utilize forward lookahead or backreference constructions are not supported.

  • Rank (integer) –

    [REQUIRED]

    Rank of the log pattern. Must be a value between 1 and 1,000,000. The patterns are sorted by rank, so we recommend that you set your highest priority patterns with the lowest rank. A pattern of rank 1 will be the first to get matched to a log line. A pattern of rank 1,000,000 will be last to get matched. When you configure custom log patterns from the console, a Low severity pattern translates to a 750,000 rank. A Medium severity pattern translates to a 500,000 rank. And a High severity pattern translates to a 250,000 rank. Rank values less than 1 or greater than 1,000,000 are reserved for Amazon Web Services provided patterns.

Return type:

dict

Returns:

Response Syntax

{
    'LogPattern': {
        'PatternSetName': 'string',
        'PatternName': 'string',
        'Pattern': 'string',
        'Rank': 123
    },
    'ResourceGroupName': 'string'
}

Response Structure

  • (dict) –

    • LogPattern (dict) –

      The successfully created log pattern.

      • PatternSetName (string) –

        The name of the log pattern. A log pattern name can contain as many as 30 characters, and it cannot be empty. The characters can be Unicode letters, digits, or one of the following symbols: period, dash, underscore.

      • PatternName (string) –

        The name of the log pattern. A log pattern name can contain as many as 50 characters, and it cannot be empty. The characters can be Unicode letters, digits, or one of the following symbols: period, dash, underscore.

      • Pattern (string) –

        A regular expression that defines the log pattern. A log pattern can contain as many as 50 characters, and it cannot be empty. The pattern must be DFA compatible. Patterns that utilize forward lookahead or backreference constructions are not supported.

      • Rank (integer) –

        Rank of the log pattern. Must be a value between 1 and 1,000,000. The patterns are sorted by rank, so we recommend that you set your highest priority patterns with the lowest rank. A pattern of rank 1 will be the first to get matched to a log line. A pattern of rank 1,000,000 will be last to get matched. When you configure custom log patterns from the console, a Low severity pattern translates to a 750,000 rank. A Medium severity pattern translates to a 500,000 rank. And a High severity pattern translates to a 250,000 rank. Rank values less than 1 or greater than 1,000,000 are reserved for Amazon Web Services provided patterns.

    • ResourceGroupName (string) –

      The name of the resource group.

Exceptions

  • ApplicationInsights.Client.exceptions.ResourceInUseException

  • ApplicationInsights.Client.exceptions.ResourceNotFoundException

  • ApplicationInsights.Client.exceptions.ValidationException

  • ApplicationInsights.Client.exceptions.InternalServerException