global_​request_​number

Version: v2024-08-13Includes use: Yes

Behavior name: Global Request Number

Generates a unique identifier for each request on the Akamai edge network for use in logging and debugging. GRN identifiers follow the same format as Akamai's error reference strings, for example: 0.05313217.1567801841.1457a3. You can use the Edge Diagnostics API's Translate error string operation to get low-level details about any request.

Default behavior

These samples reflect the behavior's default settings. You can use these as is in your configurations or make adjustments based on the behavior's available options.

data "akamai_property_rules_builder" "global_request_number" {
  rules_v2024_08_13 {
    name     = "Global Request Number"
    comments = "Generates a unique identifier for each request on the Akamai edge network for use in logging and debugging."
    behavior {
      global_request_number {
        output_option = "RESPONSE_HEADER"
        header_name   = "Akamai-GRN"
      }
    }
  }
}
"behaviors": [
  {
  "name": "globalRequestNumber",
  "options": {
    "outputOption": "RESPONSE_HEADER",
    "headername": "Akamai-GRN"
    }
  }
]

Options

Option Description
output_option
Specifies how to report the GRN value. Value is one of:
  • RESPONSE_HEADER. Use a response header.
  • REQUEST_HEADER. Use a request header.
  • BOTH_HEADERS. Use both headers.
  • ASSIGN_VARIABLE. Process the value in some other way as a variable.
header_name
With output_option set to specify any set of headers, this specifies the name of the header to report the GRN value.
variable_name
This specifies the name of the variable to assign the GRN value to. You need to pre-declare any variable you specify within the rule tree.