17-53

User

Guide

for

the

Cisco

Application

Networking

Manager

5.2

OL-26572-01

Chapter

17

Monitoring

Your

Network

Exporting

Historical

Data

The

data

export

feature

includes

a

data

dictionary

(stats-export.dict),

which

defines

the

device

type

and

record

type

and

can

be

used

to

interpret

the

data

content

and

format

of

the

exported

files.

You

can

download

the

data

dictionary,

which

is

written

in

XML,

and

display

its

content

using

IE

browser

or

any

XML

editor/viewer,

such

as

Stylus

Studio.

The

data

dictionary

can

be

used

as

a

tool

when

writing

a

script

to

extract

specific

data

from

a

data

file.

For

example,

you

can

create

a

script

that

extracts

data

based

on

a

device

type,

such

as

an

ACE,

that

shows

interface

statistics

for

a

virtual

context

within

the

ACE.

Each

record/row

in

the

exported

data

file

contains

the

following

information:

•

Timestamp

(in

the

format

defined

by

the

data

dictionary)

•

Device-type

•

Optional

record-type

(defined

in

the

data

dictionary

and

used

to

define

the

format

of

each

record)

•

Managed

entity

name

(fully

qualified

name

of

the

managed

object

with

which

the

statistical

data

is

associated;

it

should

have

the

same

name

shown

i

n

the

hi

storical

graph)

•

List

of

statistical

data

(list

order

is

defined

in

the

data

dictionary

associated

with

the

record-type)

The

first

line

of

each

exported

data

file

is

a

header

describing

the

column

of

each

row.

Each

field

of

the

record

is

separated

by

the

separator

character,

which

is

currently

defined

in

the

data

dictionary

as

the

comma.

If

the

metric

value

is

unknown,

its

value

is

left

empty.

Each

record

is

separated

by

a

new

line

character.

The

following

data

file

content

sample

shows

the

data

file

header

followed

by

the

statistical

information:

DeviceType,

RecordType,

Timestamp,

ManagedEntity,

Current

Connections,

Total

Connections,

Dropped

Connections,

Total

Client

Packets,

Total

Server

Packets,

Total

Client

Bytes,

Total

Server

Bytes,

Total

Drops

Due

To

Maximum

Connection

Limit,

Total

Drops

Due

To

Connection

Rate

Limit,

Total

Drops

Due

To

Bandwidth

Limit

DT-ACE-VC,RT-VS,2010-05-28-14:21:08,172.23.244.130:2:Admin/test/global,0,0,0,0,0,0,0,0,0,0

DT-ACE-APPLIANCE-VC,RT-VS,2010-05-28-14:21:08,172.23.244.212:Admin/test_vs_3/global,0,0,0,

0,0,0,0,0,0,0

The

header

column

names

DeviceType,

RecordType,

Timestamp,

and

ManagedEntity

are

mandatory.

The

definitions

of

the

mandatory

headers

can

be

found

in

the

fol

lowing

data

di

ctionary

XML

tags:

•

DeviceType

definition

is

inside

the

device-type

ta

g.

•

RecordType

definition

is

inside

the

record-type

tag.

•

ManagedEntity

definition

is

inside

the

managed-entity

tag.

The

column

names

that

follow

the

mandatory

names

are

the

display

names

of

the

statistic.

Guidelines

and

Restrictions:

The

data

export

guidelines

and

restrictions

are

as

follows:

•

The

time

at

which

ANM

exports

the

data

file

is

not

configurable.

•

By

default,

ANM

exports

raw

historical

data

only.

Snapshots

and

consolidated

historical

data

(average,

mi

nimum,

maximum)

are

not

exported.

The

data

export

purging

operation

gui

delines

and

restrictions

ar

e

as

fo

llows:

•

ANM

purges

exported

data

according

to

the

configurable

purging

policy.

By

default,

the

purging

policy

instructs

ANM

to

purge

the

data

file

if

it

stays

for

more

than

32

days

or

the

total

combined

export

data

is

bigger

than

10000

M

(10

G)

of

disk

space

or

the

disk

usage

is

more

than

80

percent.

•

You

can

configure

ANM

to

send

an

email

notification

to

up

t

o

five

recipients

when

the

di

sk

space

usage

is

higher

than

the

defined

threshold.

•

Each

purge

action

removes

at

least

one

day

of

exported

statistical

data.