#
# Copyright 2013 Intel Corp
#
# Licensed under the Apache License, Version 2.0 (the "License"); you may
# not use this file except in compliance with the License. You may obtain
# a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
# License for the specific language governing permissions and limitations
# under the License.
"""Tests for ceilometer/hardware/inspector/snmp/inspector.py
"""
import mock
from oslo_utils import netutils
from oslotest import mockpatch
from pysnmp.proto.rfc1905 import noSuchObject
from ceilometer.hardware.inspector import snmp
from ceilometer.tests import base as test_base
ins = snmp.SNMPInspector
[docs]class FakeObjectName(object):
def __init__(self, name):
self.name = name
def __str__(self):
return str(self.name)
[docs]class FakeCommandGenerator(object):
[docs] def getCmd(self, authData, transportTarget, *oids, **kwargs):
emptyOID = '1.3.6.1.4.1.2021.4.14.0'
varBinds = [
(FakeObjectName(oid), int(oid.split('.')[-1]))
for oid in oids
if oid != emptyOID
]
if emptyOID in oids:
varBinds += [(FakeObjectName(emptyOID), noSuchObject)]
return (None, None, 0, varBinds)
[docs] def bulkCmd(authData, transportTarget, nonRepeaters, maxRepetitions,
*oids, **kwargs):
varBindTable = [
[(FakeObjectName("%s.%d" % (oid, i)), i) for i in range(1, 3)]
for oid in oids
]
return (None, None, 0, varBindTable)
[docs]class TestSNMPInspector(test_base.BaseTestCase):
mapping = {
'test_exact': {
'matching_type': snmp.EXACT,
'metric_oid': ('1.3.6.1.4.1.2021.10.1.3.1', int),
'metadata': {
'meta': ('1.3.6.1.4.1.2021.10.1.3.8', int)
},
'post_op': '_fake_post_op',
},
'test_prefix': {
'matching_type': snmp.PREFIX,
'metric_oid': ('1.3.6.1.4.1.2021.9.1.8', int),
'metadata': {
'meta': ('1.3.6.1.4.1.2021.9.1.3', int)
},
'post_op': None,
},
'test_nosuch': {
'matching_type': snmp.EXACT,
'metric_oid': ('1.3.6.1.4.1.2021.4.14.0', int),
'metadata': {},
'post_op': None,
},
}
[docs] def setUp(self):
super(TestSNMPInspector, self).setUp()
self.inspector = snmp.SNMPInspector()
self.host = netutils.urlsplit("snmp://localhost")
self.useFixture(mockpatch.PatchObject(
snmp.cmdgen, 'CommandGenerator',
return_value=FakeCommandGenerator()))
[docs] def test_snmp_error(self):
def get_list(func, *args, **kwargs):
return list(func(*args, **kwargs))
def faux_parse(ret, is_bulk):
return (True, 'forced error')
self.useFixture(mockpatch.PatchObject(
snmp, 'parse_snmp_return', new=faux_parse))
self.assertRaises(snmp.SNMPException,
get_list,
self.inspector.inspect_generic,
host=self.host,
cache={},
extra_metadata={},
param=self.mapping['test_exact'])
@staticmethod
def _fake_post_op(host, cache, meter_def, value, metadata, extra, suffix):
metadata.update(post_op_meta=4)
extra.update(project_id=2)
return value
[docs] def test_inspect_no_such_object(self):
cache = {}
try:
# inspect_generic() is a generator, so we explicitly need to
# iterate through it in order to trigger the exception.
list(self.inspector.inspect_generic(self.host,
cache,
{},
self.mapping['test_nosuch']))
except ValueError:
self.fail("got ValueError when interpreting NoSuchObject return")
[docs] def test_inspect_generic_exact(self):
self.inspector._fake_post_op = self._fake_post_op
cache = {}
ret = list(self.inspector.inspect_generic(self.host,
cache,
{},
self.mapping['test_exact']))
keys = cache[ins._CACHE_KEY_OID].keys()
self.assertIn('1.3.6.1.4.1.2021.10.1.3.1', keys)
self.assertIn('1.3.6.1.4.1.2021.10.1.3.8', keys)
self.assertEqual(1, len(ret))
self.assertEqual(1, ret[0][0])
self.assertEqual(8, ret[0][1]['meta'])
self.assertEqual(4, ret[0][1]['post_op_meta'])
self.assertEqual(2, ret[0][2]['project_id'])
[docs] def test_inspect_generic_prefix(self):
cache = {}
ret = list(self.inspector.inspect_generic(self.host,
cache,
{},
self.mapping['test_prefix']))
keys = cache[ins._CACHE_KEY_OID].keys()
self.assertIn('1.3.6.1.4.1.2021.9.1.8' + '.1', keys)
self.assertIn('1.3.6.1.4.1.2021.9.1.8' + '.2', keys)
self.assertIn('1.3.6.1.4.1.2021.9.1.3' + '.1', keys)
self.assertIn('1.3.6.1.4.1.2021.9.1.3' + '.2', keys)
self.assertEqual(2, len(ret))
self.assertIn(ret[0][0], (1, 2))
self.assertEqual(ret[0][0], ret[0][1]['meta'])
[docs] def test_post_op_net(self):
cache = {}
metadata = dict(name='lo',
speed=0,
mac='ba21e43302fe')
extra = {}
ret = self.inspector._post_op_net(self.host, cache, None,
value=8,
metadata=metadata,
extra=extra,
suffix=".2")
self.assertEqual(8, ret)
self.assertIn('ip', metadata)
self.assertIn("2", metadata['ip'])
self.assertIn('resource_id', extra)
self.assertEqual("localhost.lo", extra['resource_id'])
[docs] def test_post_op_disk(self):
cache = {}
metadata = dict(device='/dev/sda1',
path='/')
extra = {}
ret = self.inspector._post_op_disk(self.host, cache, None,
value=8,
metadata=metadata,
extra=extra,
suffix=None)
self.assertEqual(8, ret)
self.assertIn('resource_id', extra)
self.assertEqual("localhost./dev/sda1", extra['resource_id'])
[docs] def test_prepare_params(self):
param = {'post_op': '_post_op_disk',
'oid': '1.3.6.1.4.1.2021.9.1.6',
'type': 'int',
'matching_type': 'type_prefix',
'metadata': {
'device': {'oid': '1.3.6.1.4.1.2021.9.1.3',
'type': 'str'},
'path': {'oid': '1.3.6.1.4.1.2021.9.1.2',
'type': "lambda x: str(x)"}}}
processed = self.inspector.prepare_params(param)
self.assertEqual('_post_op_disk', processed['post_op'])
self.assertEqual('1.3.6.1.4.1.2021.9.1.6', processed['metric_oid'][0])
self.assertEqual(int, processed['metric_oid'][1])
self.assertEqual(snmp.PREFIX, processed['matching_type'])
self.assertEqual(2, len(processed['metadata'].keys()))
self.assertEqual('1.3.6.1.4.1.2021.9.1.2',
processed['metadata']['path'][0])
self.assertEqual("4",
processed['metadata']['path'][1](4))
[docs] def test_pysnmp_ver43(self):
# Test pysnmp version >=4.3 compatibility of ObjectIdentifier
from distutils.version import StrictVersion
import pysnmp
has43 = StrictVersion(pysnmp.__version__) >= StrictVersion('4.3.0')
oid = '1.3.6.4.1.2021.11.57.0'
if has43:
from pysnmp.entity import engine
from pysnmp.smi import rfc1902
from pysnmp.smi import view
snmp_engine = engine.SnmpEngine()
mvc = view.MibViewController(snmp_engine.getMibBuilder())
name = rfc1902.ObjectIdentity(oid)
name.resolveWithMib(mvc)
else:
from pysnmp.proto import rfc1902
name = rfc1902.ObjectName(oid)
self.assertEqual(oid, str(name))
@mock.patch.object(snmp.cmdgen, 'UsmUserData')
[docs] def test_auth_strategy(self, mock_method):
host = ''.join(['snmp://a:b@foo?auth_proto=sha',
'&priv_password=pass&priv_proto=aes256'])
host = netutils.urlsplit(host)
self.inspector._get_auth_strategy(host)
mock_method.assert_called_with(
'a', authKey='b',
authProtocol=snmp.cmdgen.usmHMACSHAAuthProtocol,
privProtocol=snmp.cmdgen.usmAesCfb256Protocol,
privKey='pass')
host2 = 'snmp://a:b@foo?&priv_password=pass'
host2 = netutils.urlsplit(host2)
self.inspector._get_auth_strategy(host2)
mock_method.assert_called_with('a', authKey='b', privKey='pass')