API: Monitor Flow Manager Statistics

• Learn counters
  • Done: Incremented when a flow is learned successfully.
  • Ignore: Incremented when flow learning is ignored because the flow exists in the flow table.
  • Fail: Incremented when flow learning fails.
• Unlearn counters
  • Done: Incremented when a flow is unlearned successfully.
  • Ignore: Incremented when flow unlearning fails because the flow does not exist in the flow table.
• Automatic unlearn counters
  • Done: Incremented when a TCP flow is unlearned after the TCP session is terminated.
  • Ignore: Incremented when a TCP flow was already unlearned after a TCP termination is detected.
  • Fail: Incremented when unlearning of a TCP flow fails after the TCP session is terminated. The automatic unlearning operation may fail if too many TCP termination events occur within a short time interval.
• DMA counters
  • Write: Incremented when a flow is learned/unlearned by the application.
  • Info read: Incremented when a flow info record is read by the driver.
  • Info drop: Incremented when a flow info record is dropped.
  • Stat read: Incremented when a statistics record is read by the driver.
  • Stat drop: Incremented when a statistics record is dropped.

  uint8_t        adapterNo = 0;
  NtStatistics_t hStat;
  NtStatStream_t hStatStream;

  // Open the stat stream.
  status = NT_StatOpen(&hStatStream, "Read_flowstats_example");
  if(status != NT_SUCCESS) { /* Handle error */ }

  // Read the statistics counters
  hStat.cmd = NT_STATISTICS_READ_CMD_FLOW_V1;
  hStat.u.flowData_v1.clear = 0;  // Don't clear statistics
  hStat.u.flowData_v1.adapterNo = adapterNo;
  status = NT_StatRead(hStatStream, &hStat);
  if(status != NT_SUCCESS) { /* Handle error */ }

  std::cout << "Statistic from stat stream:" << std::endl
    << "  Learn:" << std::endl
    << "    Done:      " << hStat.u.flowData_v1.learnDone << std::endl
    << "    Ignore:    " << hStat.u.flowData_v1.learnIgnore << std::endl
    << "    Fail:      " << hStat.u.flowData_v1.learnFail << std::endl
    << "  Unlearn:" << std::endl
    << "    Done:      " << hStat.u.flowData_v1.unlearnDone << std::endl
    << "    Ignore:    " << hStat.u.flowData_v1.unlearnIgnore << std::endl
    << "  Automatic Unlearn:" << std::endl
    << "    Done:      " << hStat.u.flowData_v1.automaticUnlearnDone << std::endl
    << "    Ignore:    " << hStat.u.flowData_v1.automaticUnlearnIgnore << std::endl
    << "    Fail:      " << hStat.u.flowData_v1.automaticUnlearnFail << std::endl
    << "  Timeout Unlearn:" << std::endl
    << "    Done:      " << hStat.u.flowData_v1.timeoutUnlearnDone << std::endl
    << "  DMA:" << std::endl
    << "    Write:     " << hStat.u.flowData_v1.dmaWriteRecords << std::endl
    << "    Info Read: " << hStat.u.flowData_v1.dmaReadInfoRecords << std::endl
    << "    Stat Read: " << hStat.u.flowData_v1.dmaReadStatRecords << std::endl;
    << "  Current Flow Count: " << hStat.u.flowData_v1.currentFlowCount << std::endl;

StatInterval = 100