Decode and Extract true Bits as Arrays | LogScale Query Examples

Decode and Extract `true` Bits as Arrays

Decode and extract true bits as arrays using the bitfield:extractFlagsAsArray() function

Query

logscale

bitfield:extractFlagsAsArray(field="MemoryDescriptionFlags", flagNames=[
[0,INVALID_ADDRESS],
[1,CURRENT_STACK],
[2,JIT_DOTNET],
[3,MZ],
[4,CODE],
[5,MODULE],
[6,MAPPED],
[7,REFLECIVE_PE],
[8,JIT_FLASH],
[9,PRIMARY_MODULE],
[10,PRIVATE_MEMORY],
[11,KNOWN_FUNCTION],
[12,FREE_MEMORY]], asArray="flagsArray[]")

Introduction

The bitfield:extractFlagsAsArray() function can be used to decode an integer to its bit-representation and extract the true bits at specified indices with specified names to an array. The array will contain the names of the set bits, listed in ascending order, from lowest bit to highest bit. The bits are indexed from 0 and will include up to 64 bits. If the value in the input field is larger, the lowest 64 bits will be used.

In this example, the bitfield:extractFlagsAsArray() function is used to decode the field MemoryDescriptionFlags and extract its true bits.

Example incoming data might look like this:

Raw Events

MemoryDescriptionFlags,1234

// corresponds to 10011010010

Step-by-Step

Starting with the source repository events.
flowchart LR; %%{init: {"flowchart": {"defaultRenderer": "elk"}} }%% repo{{Events}} 0[/Filter/] result{{Result Set}} repo --> 0 0 --> result style 0 fill:#ff0000,stroke-width:4px,stroke:#000;
logscale
```
bitfield:extractFlagsAsArray(field="MemoryDescriptionFlags", flagNames=[
[0,INVALID_ADDRESS],
[1,CURRENT_STACK],
[2,JIT_DOTNET],
[3,MZ],
[4,CODE],
[5,MODULE],
[6,MAPPED],
[7,REFLECIVE_PE],
[8,JIT_FLASH],
[9,PRIMARY_MODULE],
[10,PRIVATE_MEMORY],
[11,KNOWN_FUNCTION],
[12,FREE_MEMORY]], asArray="flagsArray[]")
```
Decodes the field MemoryDescriptionFlags and extracts the true bits at specified indices with specified names to an array named flagsArray[]. The array will contain the names of the set bits, listed in ascending order, from lowest bit to highest bit.
Event Result set.