ddusage

README

ddusage

A tool that shows a breakdown of Datadog usages in a table.

Usage

Usage: ddusage --api-key=STRING --app-key=STRING

Flags:
  -h, --help                   Show context-sensitive help.
      --api-key=STRING         Datadog API key ($DD_API_KEY).
      --app-key=STRING         Datadog APP key ($DD_APP_KEY).
  -x, --include-org-details    Include usage summaries for each sub-org..
  -o, --output="table"         Formatting style for output (table, tsv, json, csv).
  -s, --start-month=STRING     Usage beginning this month.
  -e, --end-month=STRING       Usage ending this month.
  -H, --humanize               Convert usage numbers to to human-friendly strings.
      --version

$ export DD_API_KEY=...
$ export DD_APP_KEY=...
$ ddusage -x -H
       ORG       |               PRODUCT               | 2022-12 | 2023-01 | 2023-02 | 2023-03 | 2023-04
-----------------+-------------------------------------+---------+---------+---------+---------+----------
  organization1  | apm_host_incl_usm_top99p            | 1       | 1       | 1       | 1       | 1
  organization2  | logs_indexed_logs_usage_sum_15_day  | 1M      | 1M      | 1M      | 1M      | 1M

Installation

brew install winebarrel/ddusage/ddusage

Related Links

• https://github.com/winebarrel/ddcost

Documentation

Index

• type Client
  • func NewClient(options *ClientOptions) *Client
  • func (client *Client) PrintUsageSummary(out io.Writer, options *PrintUsageSummaryOptions) error
• type ClientOptions
• type PrintUsageSummaryOptions
• type Usage
  • func (c Usage) Float64() float64
  • func (c Usage) String() string
• type UsageBreakdown
• type UsageByMonth
• type UsageByProduct

Types

type Client

type Client struct {
	// contains filtered or unexported fields
}

func NewClient

func NewClient(options *ClientOptions) *Client

func (*Client) PrintUsageSummary

func (client *Client) PrintUsageSummary(out io.Writer, options *PrintUsageSummaryOptions) error

type ClientOptions

type ClientOptions struct {
	APIKey string `env:"DD_API_KEY" required:"" help:"Datadog API key."`
	APPKey string `env:"DD_APP_KEY" required:"" help:"Datadog APP key."`
}

type PrintUsageSummaryOptions

type PrintUsageSummaryOptions struct {
	IncludeOrgDetails bool   `short:"x" help:"Include usage summaries for each sub-org.."`
	Output            string `short:"o" enum:"table,tsv,json,csv" default:"table" help:"Formatting style for output (table, tsv, json, csv)."`
	StartMonth        string `short:"s" help:"Usage beginning this month."`
	EndMonth          string `short:"e" help:"Usage ending this month."`
	Humanize          bool   `short:"H" help:"Convert usage numbers to to human-friendly strings."`
}

type Usage

type Usage float64

func (Usage) Float64

func (c Usage) Float64() float64

func (Usage) String

func (c Usage) String() string

type UsageBreakdown

type UsageBreakdown map[string]UsageByProduct

org_name/product_name/month/cost

type UsageByMonth

type UsageByMonth map[string]Usage

month/usage

type UsageByProduct

type UsageByProduct map[string]UsageByMonth

product_name/month/usage