/* Real-time Online/Offline Charging System (OCS) for Telecom & ISP environments Copyright (C) ITsysCOM GmbH This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see */ package engine import ( "encoding/json" "fmt" "math" "strconv" "time" "github.com/cgrates/cgrates/config" "github.com/cgrates/cgrates/utils" ) func NewCDRFromExternalCDR(extCdr *ExternalCDR, timezone string) (*CDR, error) { var err error cdr := &CDR{CGRID: extCdr.CGRID, RunID: extCdr.RunID, OrderID: extCdr.OrderID, ToR: extCdr.ToR, OriginID: extCdr.OriginID, OriginHost: extCdr.OriginHost, Source: extCdr.Source, RequestType: extCdr.RequestType, Tenant: extCdr.Tenant, Category: extCdr.Category, Account: extCdr.Account, Subject: extCdr.Subject, Destination: extCdr.Destination, CostSource: extCdr.CostSource, Cost: extCdr.Cost, PreRated: extCdr.PreRated} if extCdr.SetupTime != "" { if cdr.SetupTime, err = utils.ParseTimeDetectLayout(extCdr.SetupTime, timezone); err != nil { return nil, err } } if len(cdr.CGRID) == 0 { // Populate CGRID if not present cdr.ComputeCGRID() } if extCdr.AnswerTime != "" { if cdr.AnswerTime, err = utils.ParseTimeDetectLayout(extCdr.AnswerTime, timezone); err != nil { return nil, err } } if extCdr.Usage != "" { if cdr.Usage, err = utils.ParseDurationWithNanosecs(extCdr.Usage); err != nil { return nil, err } } if len(extCdr.CostDetails) != 0 { cdr.CostDetails = &EventCost{} if err = json.Unmarshal([]byte(extCdr.CostDetails), cdr.CostDetails); err != nil { return nil, err } } if extCdr.ExtraFields != nil { cdr.ExtraFields = make(map[string]string) } for k, v := range extCdr.ExtraFields { cdr.ExtraFields[k] = v } return cdr, nil } func NewCDRWithDefaults(cfg *config.CGRConfig) *CDR { return &CDR{ ToR: utils.VOICE, RequestType: cfg.GeneralCfg().DefaultReqType, Tenant: cfg.GeneralCfg().DefaultTenant, Category: cfg.GeneralCfg().DefaultCategory, ExtraFields: make(map[string]string), Cost: -1, } } type CDR struct { CGRID string RunID string OrderID int64 // Stor order id used as export order id OriginHost string // represents the IP address of the host generating the CDR (automatically populated by the server) Source string // formally identifies the source of the CDR (free form field) OriginID string // represents the unique accounting id given by the telecom switch generating the CDR ToR string // type of record, meta-field, should map to one of the TORs hardcoded inside the server <*voice|*data|*sms|*generic> RequestType string // matching the supported request types by the **CGRateS**, accepted values are hardcoded in the server . Tenant string // tenant whom this record belongs Category string // free-form filter for this record, matching the category defined in rating profiles. Account string // account id (accounting subsystem) the record should be attached to Subject string // rating subject (rating subsystem) this record should be attached to Destination string // destination to be charged SetupTime time.Time // set-up time of the event. Supported formats: datetime RFC3339 compatible, SQL datetime (eg: MySQL), unix timestamp. AnswerTime time.Time // answer time of the event. Supported formats: datetime RFC3339 compatible, SQL datetime (eg: MySQL), unix timestamp. Usage time.Duration // event usage information (eg: in case of tor=*voice this will represent the total duration of a call) ExtraFields map[string]string // Extra fields to be stored in CDR ExtraInfo string // Container for extra information related to this CDR, eg: populated with error reason in case of error on calculation Partial bool // Used for partial record processing by CDRC PreRated bool // Mark the CDR as rated so we do not process it during rating CostSource string // The source of this cost Cost float64 // CostDetails *EventCost // Attach the cost details to CDR when possible } // AddDefaults will add missing information based on other fields func (cdr *CDR) AddDefaults(cfg *config.CGRConfig) { if cdr.CGRID == utils.EmptyString { cdr.ComputeCGRID() } if cdr.RunID == utils.EmptyString { cdr.RunID = utils.MetaRaw } if cdr.ToR == utils.EmptyString { cdr.ToR = utils.VOICE } if cdr.RequestType == utils.EmptyString { cdr.RequestType = cfg.GeneralCfg().DefaultReqType } if cdr.Tenant == utils.EmptyString { cdr.Tenant = cfg.GeneralCfg().DefaultTenant } if cdr.Category == utils.EmptyString { cdr.Category = cfg.GeneralCfg().DefaultCategory } if cdr.Subject == utils.EmptyString { cdr.Subject = cdr.Account } } func (cdr *CDR) CostDetailsJson() string { mrshled, _ := json.Marshal(cdr.CostDetails) return string(mrshled) } func (cdr *CDR) ComputeCGRID() { cdr.CGRID = utils.Sha1(cdr.OriginID, cdr.OriginHost) } // Format cost as string on export func (cdr *CDR) FormatCost(shiftDecimals, roundDecimals int) string { cost := cdr.Cost if shiftDecimals != 0 { cost = cost * math.Pow10(shiftDecimals) } return strconv.FormatFloat(cost, 'f', roundDecimals, 64) } // Used to retrieve fields as string, primary fields are const labeled func (cdr *CDR) FieldAsString(rsrPrs *config.RSRParser) (parsed string, err error) { parsed, err = rsrPrs.ParseDataProviderWithInterfaces(config.NewNavigableMap(cdr.AsMapStringIface()), utils.NestingSep) if err != nil { return } return } // concatenates values of multiple fields defined in template, used eg in CDR templates func (cdr *CDR) FieldsAsString(rsrFlds config.RSRParsers) string { outVal, err := rsrFlds.ParseDataProviderWithInterfaces(config.NewNavigableMap(cdr.AsMapStringIface()), utils.NestingSep) if err != nil { return "" } return outVal } // Populates the field with id from value; strings are appended to original one func (cdr *CDR) ParseFieldValue(fieldId, fieldVal, timezone string) error { var err error switch fieldId { case utils.OrderID: if cdr.OrderID, err = strconv.ParseInt(fieldVal, 10, 64); err != nil { return err } case utils.OriginHost: // overwrite if originHost is given from template cdr.OriginHost = fieldVal case utils.ToR: cdr.ToR = fieldVal case utils.RunID: cdr.RunID = fieldVal case utils.OriginID: cdr.OriginID = fieldVal case utils.RequestType: cdr.RequestType = fieldVal case utils.Tenant: cdr.Tenant = fieldVal case utils.Category: cdr.Category = fieldVal case utils.Account: cdr.Account = fieldVal case utils.Subject: cdr.Subject = fieldVal case utils.Destination: cdr.Destination = fieldVal case utils.PreRated: cdr.PreRated, _ = strconv.ParseBool(fieldVal) case utils.SetupTime: if cdr.SetupTime, err = utils.ParseTimeDetectLayout(fieldVal, timezone); err != nil { return fmt.Errorf("Cannot parse answer time field with value: %s, err: %s", fieldVal, err.Error()) } case utils.AnswerTime: if cdr.AnswerTime, err = utils.ParseTimeDetectLayout(fieldVal, timezone); err != nil { return fmt.Errorf("Cannot parse answer time field with value: %s, err: %s", fieldVal, err.Error()) } case utils.Usage: if cdr.Usage, err = utils.ParseDurationWithNanosecs(fieldVal); err != nil { return fmt.Errorf("Cannot parse duration field with value: %s, err: %s", fieldVal, err.Error()) } case utils.COST: if cdr.Cost, err = strconv.ParseFloat(fieldVal, 64); err != nil { return fmt.Errorf("Cannot parse cost field with value: %s, err: %s", fieldVal, err.Error()) } case utils.Partial: cdr.Partial, _ = strconv.ParseBool(fieldVal) default: // Extra fields will not match predefined so they all show up here cdr.ExtraFields[fieldId] = fieldVal } return nil } func (cdr *CDR) Clone() *CDR { var clnedCDR CDR utils.Clone(cdr, &clnedCDR) return &clnedCDR } func (cdr *CDR) AsMapStringIface() (mp map[string]interface{}) { mp = make(map[string]interface{}) for fld, val := range cdr.ExtraFields { mp[fld] = val } mp[utils.CGRID] = cdr.CGRID mp[utils.RunID] = cdr.RunID mp[utils.OrderID] = cdr.OrderID mp[utils.OriginHost] = cdr.OriginHost mp[utils.Source] = cdr.Source mp[utils.OriginID] = cdr.OriginID mp[utils.ToR] = cdr.ToR mp[utils.RequestType] = cdr.RequestType mp[utils.Tenant] = cdr.Tenant mp[utils.Category] = cdr.Category mp[utils.Account] = cdr.Account mp[utils.Subject] = cdr.Subject mp[utils.Destination] = cdr.Destination mp[utils.SetupTime] = cdr.SetupTime mp[utils.AnswerTime] = cdr.AnswerTime mp[utils.Usage] = cdr.Usage mp[utils.ExtraInfo] = cdr.ExtraInfo mp[utils.Partial] = cdr.Partial mp[utils.PreRated] = cdr.PreRated mp[utils.CostSource] = cdr.CostSource mp[utils.Cost] = cdr.Cost if cdr.CostDetails != nil { var result map[string]interface{} json.Unmarshal([]byte(utils.ToJSON(cdr.CostDetails)), &result) mp[utils.CostDetails] = result } return } func (cdr *CDR) AsExternalCDR() *ExternalCDR { var usageStr string switch cdr.ToR { case utils.VOICE: // usage as time usageStr = cdr.Usage.String() default: // usage as units usageStr = strconv.FormatInt(cdr.Usage.Nanoseconds(), 10) } return &ExternalCDR{CGRID: cdr.CGRID, RunID: cdr.RunID, OrderID: cdr.OrderID, OriginHost: cdr.OriginHost, Source: cdr.Source, OriginID: cdr.OriginID, ToR: cdr.ToR, RequestType: cdr.RequestType, Tenant: cdr.Tenant, Category: cdr.Category, Account: cdr.Account, Subject: cdr.Subject, Destination: cdr.Destination, SetupTime: cdr.SetupTime.Format(time.RFC3339), AnswerTime: cdr.AnswerTime.Format(time.RFC3339), Usage: usageStr, ExtraFields: cdr.ExtraFields, CostSource: cdr.CostSource, Cost: cdr.Cost, CostDetails: cdr.CostDetailsJson(), ExtraInfo: cdr.ExtraInfo, PreRated: cdr.PreRated, } } func (cdr *CDR) String() string { mrsh, _ := json.Marshal(cdr) return string(mrsh) } // combimedCdrFieldVal groups together CDRs with same CGRID and combines their values matching filter field ID func (cdr *CDR) combimedCdrFieldVal(cfgCdrFld *config.FCTemplate, groupCDRs []*CDR, filterS *FilterS) (string, error) { var combinedVal string // Will result as combination of the field values, filters must match for _, filterRule := range cfgCdrFld.Value { pairingVal, err := cdr.FieldAsString(filterRule) if err != nil { return "", err } for _, grpCDR := range groupCDRs { if cdr.CGRID != grpCDR.CGRID { continue // We only care about cdrs with same primary cdr behind } if valStr, err := grpCDR.FieldAsString(filterRule); err != nil { return "", err } else if valStr != pairingVal { // First CDR with field equal with ours continue } combinedVal += grpCDR.FieldsAsString(cfgCdrFld.Value) } } return combinedVal, nil } // Extracts the value specified by cfgHdr out of cdr, used for export values func (cdr *CDR) exportFieldValue(cfgCdrFld *config.FCTemplate, filterS *FilterS) (retVal string, err error) { for _, rsrFld := range cfgCdrFld.Value { var cdrVal string switch cfgCdrFld.Tag { case utils.COST: cdrVal = cdr.FormatCost(cfgCdrFld.CostShiftDigits, cfgCdrFld.RoundingDecimals) case utils.SetupTime: if cfgCdrFld.Layout == "" { cfgCdrFld.Layout = time.RFC3339 } cdrVal = cdr.SetupTime.Format(cfgCdrFld.Layout) case utils.AnswerTime: // Format time based on layout if cfgCdrFld.Layout == "" { cfgCdrFld.Layout = time.RFC3339 } cdrVal = cdr.AnswerTime.Format(cfgCdrFld.Layout) case utils.Destination: cdrVal, err = cdr.FieldAsString(rsrFld) if err != nil { return "", err } if cfgCdrFld.MaskLen != -1 && len(cfgCdrFld.MaskDestID) != 0 && CachedDestHasPrefix(cfgCdrFld.MaskDestID, cdrVal) { cdrVal = utils.MaskSuffix(cdrVal, cfgCdrFld.MaskLen) } default: cdrVal, err = cdr.FieldAsString(rsrFld) if err != nil { return "", err } } retVal += cdrVal } return } func (cdr *CDR) formatField(cfgFld *config.FCTemplate, httpSkipTlsCheck bool, groupedCDRs []*CDR, filterS *FilterS) (outVal string, err error) { switch cfgFld.Type { case utils.META_FILLER: outVal, err = cfgFld.Value.ParseValue(utils.EmptyString) cfgFld.Padding = "right" case utils.META_CONSTANT: outVal, err = cfgFld.Value.ParseValue(utils.EmptyString) case utils.MetaDateTime: // Convert the requested field value into datetime with layout rawVal, err := cdr.exportFieldValue(cfgFld, filterS) if err != nil { return "", err } if dtFld, err := utils.ParseTimeDetectLayout(rawVal, cfgFld.Timezone); err != nil { // Only one rule makes sense here return "", err } else { if cfgFld.Layout == "" { cfgFld.Layout = time.RFC3339 } outVal = dtFld.Format(cfgFld.Layout) } case utils.META_HTTP_POST: var outValByte []byte httpAddr, err := cfgFld.Value.ParseValue(utils.EmptyString) if err != nil { return "", err } jsn, err := json.Marshal(cdr) if err != nil { return "", err } if len(httpAddr) == 0 { err = fmt.Errorf("Empty http address for field %s type %s", cfgFld.Tag, cfgFld.Type) } else if outValByte, err = HttpJsonPost(httpAddr, httpSkipTlsCheck, jsn); err == nil { outVal = string(outValByte) if len(outVal) == 0 && cfgFld.Mandatory { err = fmt.Errorf("Empty result for http_post field: %s", cfgFld.Tag) } } case utils.META_COMBIMED: outVal, err = cdr.combimedCdrFieldVal(cfgFld, groupedCDRs, filterS) case utils.META_COMPOSED: outVal, err = cdr.exportFieldValue(cfgFld, filterS) case utils.MetaMaskedDestination: if len(cfgFld.MaskDestID) != 0 && CachedDestHasPrefix(cfgFld.MaskDestID, cdr.Destination) { outVal = "1" } else { outVal = "0" } } if err != nil && (err != utils.ErrNotFound || cfgFld.Mandatory) { return "", err } return utils.FmtFieldWidth(cfgFld.Tag, outVal, cfgFld.Width, cfgFld.Strip, cfgFld.Padding, cfgFld.Mandatory) } // Used in place where we need to export the CDR based on an export template // ExportRecord is a []string to keep it compatible with encoding/csv Writer func (cdr *CDR) AsExportRecord(exportFields []*config.FCTemplate, httpSkipTlsCheck bool, groupedCDRs []*CDR, filterS *FilterS) (expRecord []string, err error) { for _, cfgFld := range exportFields { if pass, err := filterS.Pass(cdr.Tenant, cfgFld.Filters, config.NewNavigableMap(cdr.AsMapStringIface())); err != nil { return []string{}, err } else if !pass { continue } if fmtOut, err := cdr.formatField(cfgFld, httpSkipTlsCheck, groupedCDRs, filterS); err != nil { utils.Logger.Warning(fmt.Sprintf(" error: %s exporting field: %s, CDR: %s\n", err.Error(), utils.ToJSON(cfgFld), utils.ToJSON(cdr))) return nil, err } else { expRecord = append(expRecord, fmtOut) } } return expRecord, nil } // AsExportMap converts the CDR into a map[string]string based on export template // Used in real-time replication as well as remote exports func (cdr *CDR) AsExportMap(exportFields []*config.FCTemplate, httpSkipTlsCheck bool, groupedCDRs []*CDR, filterS *FilterS) (expMap map[string]string, err error) { expMap = make(map[string]string) for _, cfgFld := range exportFields { if pass, err := filterS.Pass(cdr.Tenant, cfgFld.Filters, config.NewNavigableMap(cdr.AsMapStringIface())); err != nil { return nil, err } else if !pass { continue } if fmtOut, err := cdr.formatField(cfgFld, httpSkipTlsCheck, groupedCDRs, filterS); err != nil { utils.Logger.Warning(fmt.Sprintf(" error: %s exporting field: %s, CDR: %s\n", err.Error(), utils.ToJSON(cfgFld), utils.ToJSON(cdr))) return nil, err } else { expMap[cfgFld.FieldId] += fmtOut } } return } // AsCDRsTBL converts the CDR into the format used for SQL storage func (cdr *CDR) AsCDRsql() (cdrSql *CDRsql) { cdrSql = new(CDRsql) cdrSql.Cgrid = cdr.CGRID cdrSql.RunID = cdr.RunID cdrSql.OriginHost = cdr.OriginHost cdrSql.Source = cdr.Source cdrSql.OriginID = cdr.OriginID cdrSql.TOR = cdr.ToR cdrSql.RequestType = cdr.RequestType cdrSql.Tenant = cdr.Tenant cdrSql.Category = cdr.Category cdrSql.Account = cdr.Account cdrSql.Subject = cdr.Subject cdrSql.Destination = cdr.Destination cdrSql.SetupTime = cdr.SetupTime cdrSql.AnswerTime = cdr.AnswerTime cdrSql.Usage = cdr.Usage.Nanoseconds() cdrSql.ExtraFields = utils.ToJSON(cdr.ExtraFields) cdrSql.CostSource = cdr.CostSource cdrSql.Cost = cdr.Cost cdrSql.CostDetails = utils.ToJSON(cdr.CostDetails) cdrSql.ExtraInfo = cdr.ExtraInfo cdrSql.CreatedAt = time.Now() return } func (cdr *CDR) AsCGREvent() *utils.CGREvent { return &utils.CGREvent{ Tenant: cdr.Tenant, ID: utils.UUIDSha1Prefix(), Event: cdr.AsMapStringIface(), } } // UpdateFromCGREvent will update CDR with event fields from CGREvent func (cdr *CDR) UpdateFromCGREvent(cgrEv *utils.CGREvent, fields []string) (err error) { for _, fldName := range fields { if _, has := cgrEv.Event[fldName]; !has { continue //maybe removed } switch fldName { case utils.OriginHost: if cdr.OriginHost, err = cgrEv.FieldAsString(fldName); err != nil { return } case utils.Source: if cdr.Source, err = cgrEv.FieldAsString(fldName); err != nil { return } case utils.ToR: if cdr.ToR, err = cgrEv.FieldAsString(fldName); err != nil { return } case utils.RequestType: if cdr.RequestType, err = cgrEv.FieldAsString(fldName); err != nil { return } case utils.Tenant: if cdr.Tenant, err = cgrEv.FieldAsString(fldName); err != nil { return } case utils.Category: if cdr.Category, err = cgrEv.FieldAsString(fldName); err != nil { return } case utils.Account: if cdr.Account, err = cgrEv.FieldAsString(fldName); err != nil { return } case utils.Subject: if cdr.Subject, err = cgrEv.FieldAsString(fldName); err != nil { return } case utils.Destination: if cdr.Destination, err = cgrEv.FieldAsString(fldName); err != nil { return } case utils.SetupTime: if cdr.SetupTime, err = cgrEv.FieldAsTime(fldName, config.CgrConfig().GeneralCfg().DefaultTimezone); err != nil { return } case utils.AnswerTime: if cdr.AnswerTime, err = cgrEv.FieldAsTime(fldName, config.CgrConfig().GeneralCfg().DefaultTimezone); err != nil { return } case utils.Usage: if cdr.Usage, err = cgrEv.FieldAsDuration(fldName); err != nil { return } default: fldVal, err := cgrEv.FieldAsString(fldName) if err != nil { return err } cdr.ExtraFields[fldName] = fldVal } } return } // NewCDRFromSQL converts the CDRsql into CDR func NewCDRFromSQL(cdrSql *CDRsql) (cdr *CDR, err error) { cdr = new(CDR) cdr.CGRID = cdrSql.Cgrid cdr.RunID = cdrSql.RunID cdr.OriginHost = cdrSql.OriginHost cdr.Source = cdrSql.Source cdr.OriginID = cdrSql.OriginID cdr.OrderID = cdrSql.ID cdr.ToR = cdrSql.TOR cdr.RequestType = cdrSql.RequestType cdr.Tenant = cdrSql.Tenant cdr.Category = cdrSql.Category cdr.Account = cdrSql.Account cdr.Subject = cdrSql.Subject cdr.Destination = cdrSql.Destination cdr.SetupTime = cdrSql.SetupTime cdr.AnswerTime = cdrSql.AnswerTime cdr.Usage = time.Duration(cdrSql.Usage) cdr.CostSource = cdrSql.CostSource cdr.Cost = cdrSql.Cost cdr.ExtraInfo = cdrSql.ExtraInfo if cdrSql.ExtraFields != "" { if err = json.Unmarshal([]byte(cdrSql.ExtraFields), &cdr.ExtraFields); err != nil { return nil, err } } if cdrSql.CostDetails != "" { if err = json.Unmarshal([]byte(cdrSql.CostDetails), &cdr.CostDetails); err != nil { return nil, err } } return } type ExternalCDR struct { CGRID string RunID string OrderID int64 OriginHost string Source string OriginID string ToR string RequestType string Tenant string Category string Account string Subject string Destination string SetupTime string AnswerTime string Usage string ExtraFields map[string]string CostSource string Cost float64 CostDetails string ExtraInfo string PreRated bool // Mark the CDR as rated so we do not process it during mediation } // Used when authorizing requests from outside, eg ApierV1.GetMaxUsage type UsageRecord struct { ToR string RequestType string Tenant string Category string Account string Subject string Destination string SetupTime string AnswerTime string Usage string ExtraFields map[string]string } func (self *UsageRecord) AsCDR(timezone string) (*CDR, error) { var err error cdr := &CDR{CGRID: self.GetId(), ToR: self.ToR, RequestType: self.RequestType, Tenant: self.Tenant, Category: self.Category, Account: self.Account, Subject: self.Subject, Destination: self.Destination} if cdr.SetupTime, err = utils.ParseTimeDetectLayout(self.SetupTime, timezone); err != nil { return nil, err } if cdr.AnswerTime, err = utils.ParseTimeDetectLayout(self.AnswerTime, timezone); err != nil { return nil, err } if cdr.Usage, err = utils.ParseDurationWithNanosecs(self.Usage); err != nil { return nil, err } if self.ExtraFields != nil { cdr.ExtraFields = make(map[string]string) } for k, v := range self.ExtraFields { cdr.ExtraFields[k] = v } return cdr, nil } func (self *UsageRecord) AsCallDescriptor(timezone string, denyNegative bool) (*CallDescriptor, error) { var err error cd := &CallDescriptor{ CgrID: self.GetId(), TOR: self.ToR, Tenant: self.Tenant, Category: self.Category, Subject: self.Subject, Account: self.Account, Destination: self.Destination, DenyNegativeAccount: denyNegative, } timeStr := self.AnswerTime if len(timeStr) == 0 { // In case of auth, answer time will not be defined, so take it out of setup one timeStr = self.SetupTime } if cd.TimeStart, err = utils.ParseTimeDetectLayout(timeStr, timezone); err != nil { return nil, err } if usage, err := utils.ParseDurationWithNanosecs(self.Usage); err != nil { return nil, err } else { cd.TimeEnd = cd.TimeStart.Add(usage) } if self.ExtraFields != nil { cd.ExtraFields = make(map[string]string) } for k, v := range self.ExtraFields { cd.ExtraFields[k] = v } return cd, nil } func (self *UsageRecord) GetId() string { return utils.Sha1(self.ToR, self.RequestType, self.Tenant, self.Category, self.Account, self.Subject, self.Destination, self.SetupTime, self.AnswerTime, self.Usage) } type CDRWithArgDispatcher struct { *CDR *utils.ArgDispatcher } type ExternalCDRWithArgDispatcher struct { *ExternalCDR *utils.ArgDispatcher } type UsageRecordWithArgDispatcher struct { *UsageRecord *utils.ArgDispatcher }