Configure GCB Settings

You can configure the following settings in GigaVUE-FM:

GCB General Settings

In the GCB General Settings, you can specify the purge interval to automatically remove the GCBs that are disconnected for a long duration.

Note:  GigaVUE-FM generates an alarm for the disconnected GCB when the GCB heartbeats are not received for more than 15 minutes. Refer to Alarms for detailed information on Alarms.

To view or edit the GCB general settings:

  1. In GigaVUE-FM, navigate to Inventory > CONTAINER > Gigamon Containerized Broker > Settings, the Settings page appears.
  2. From the Settings page, on the General section, click Edit. The Edit General Settings quick view appears.

  3. Enter the number of days to retain the disconnected GCB and after this duration the disconnected GCB will be removed.
  4. Click Save to changes made on the General Settings. 

GCB Individual Settings

In GigaVUE-FM, you can control the level of logs created at each individual GCB for troubleshooting. The regular GCB log file name format is gcb_http2.log.

To view or edit the GCB log level settings:

  1. In GigaVUE-FM, navigate to Inventory > CONTAINER > Gigamon Containerized Broker > Settings, the Settings page appears.
  2. From the Settings page, select a GCB to view or edit the GCB log configuration.
  3. Select Edit to edit the required GCB log values in the Individual Settings section. 

    Field

    		Description
    Log Level

    Select one of the following:

    • DEBUG—fine-grained log information for application debugging
    • INFO—coarse-grained log information for highlighting application progress
    • WARN—log information of potentially harmful situations
    • ERROR—log information of the error events that allows the application to run continuously
    • FATAL—log information of very severe error events that presumably lead the application to abort.

    Log File Size

    Enter a value for the number of lines in the GCB log file.

    PCAP File Generation

    Select Yes to generate the PCAP file and select No to continue without the PCAP file.

    Number of PCAP Files Generated

    Enter a value for the number of PCAP files to be generated and stored on the GCB.

On any of the above fields,

  • click Reset to reset the value to default.
  • click Apply to Group to apply the value to all the members of the group

The GCB considers an HTTPS POST message from Pcapper to GCB as a transaction. The Transaction Logging feature collects data from the transaction to aid in troubleshooting problems such as dropped packets, or no traffic at tools. For each transaction, GCB creates a transaction record. The transaction record is logged to a transaction log file in the GCB pod or into the Kubernetes logging stdout stream.

The transaction log consists of various items like transaction index, transaction time, source, and destination details extracted from the data sources like GCB system time, Pcapper metadata field, and Pcapper transaction. Each pod can have a maximum of ten log files.

The GCB transaction log file name format is gcb_trans_<YYYY-MM-DD_hh-mm-ss>.<csv | json>, and the file is located on each GCB Pod in the /pod-data directory.

To view or edit the transaction log settings:

  1. In GigaVUE-FM, navigate to Inventory > CONTAINER > Gigamon Containerized Broker > Settings, the Settings page appears.
  2. From the Settings page, select a GCB to view or edit the GCB transaction log settings.
  3. Select Edit to edit the required GCB transaction log values in the Individual Settings section. 

    Field

    		Description

    Transaction Logging

    Select Yes to enable the transaction logs generation or select No to disable the transaction logs generation.

    Write Transaction Log to a File

    Select Yes to save the generated transaction logs to a file on your GCB HTTPS Pods or select No to continue without saving the logs to a file.

    Write Transaction Log to stdout

    Select Yes to save the generated transaction logs to your Kubernetes logging standard output stream or select No to continue without saving the logs to your Kubernetes stdout.

    Refer to Kubernetes Logging Architecture for detailed information on Kubernetes stdout.

    Transaction Log Format

    Select CSV or JSON as the transaction log file format.

    Transaction Log File Size (MB)

    Enter a value between 1 MB to 4095 MB for the transaction log file size.

    A new log file is created whenever the log file reaches the specified file size.

    Unify All Settings

    Enable the Unify All Settings option to apply all the log settings to the members of the group.

On any of the above fields,

  • click Reset to reset the value to default.
  • click Apply to Group to apply the value to all the members of the group

GCB Group Settings

GCB Group settings allow you to configure group settings such as packet reordering settings to multiple GCBs present in a group. It allows you to create a group consisting of multiple GCBs with the same settings. You can change one or more group settings for a GCB group, and the changes are applied to all the GCBs in the group. You can create many GCB groups, but the group name should be different.

When the GCB receives HTTPS POST request from Pcapper, it extracts the headers, metadata, and packets from the message. After extraction, GCB applies the traffic policy and service identification and forwards packets to the destination.

In some cases, a single request may not have the complete transaction, or the request may have packets that are out of order. The GCB packet reordering functionality fixes these out of order packets and makes a complete transaction for tool effectiveness. When the GCB receives a request from Pcapper, GCB checks for complete transaction using a combination of metadata fields and the flow of the extracted messages.

GCB stores the request in a queue with a time stamp and waits until the transaction is complete. When the queue reaches the maximum storage limit, then GCB drops the oldest or the most recent request based on the selected policy.

To view or edit the GCB packet reordering settings:

  1. In GigaVUE-FM, navigate to Inventory > CONTAINER > Gigamon Containerized Broker > Settings, the Settings page appears.
  2. From the Settings page, select a GCB to view or edit the GCB packet reordering settings.
  3. Select Edit to edit the required GCB packet reordering values in the Group Settings section. 

    Field

    		Description

    Enable/disable packet reordering functionality

    Select Yes to enable the packet reordering functionality or select No to disable the packet reordering functionality.

    Use sequence number for packet reordering

    Select Yes to use sequencing numbers for packet reordering or select No to reorder packets based on timestamps.

    Use timestamp for packet reordering

    Select Yes to use time stamps for packet reordering or select No to continue without using time stamps for the packet reordering.

    Packet reordering timeout in milliseconds

    Enter a value between 10000 to 3600000 milliseconds for the packet reordering timeout.

    Packet reordering timeout in the duration, the GCB waits for the pending packets to complete the transaction, and after this timeout, all the related packets are dropped.

    Maximum number of requests stored in queue

    Enter a value between 1000 to 100000 requests for the maximum number of requests that can be stored in the queue.

    Packet reordering drop policy

    Select Drop most recent to drop the most recent packets when the queue is overloaded or select Drop oldest to drop the old packets when the queue is overloaded.