Interface Description¶

Интерфейс для взаимодействия с опросом линковки по описаниям (Description) интерфейсов. Запускается в рамках опроса ifdescr, если выбран в настройках ManagedObjectProfile - настройка ifdescr_handler.

Interface Description применяется в ходе опроса IfDescr.

interface_description(managed_object, interface):
    Implements Interace Description

    :param managed_object: Managed Object instance
    :param interface: Interface instance
    :returns:

Примеры¶

Построение линков по hostname в дескрипшенах¶

Позволяет соединять (Linking) устройства в описаниях интерфейсов которых указан hostname соседа. device1 - hostname2 <-> hostname1 device2. Возвращает интерфейс соседа с котором необходимо соединить локальный интерфейсу.

    # Python modules
    import re
    import logging

    # NOC modules
    from noc.inv.models.discoveryid import DiscoveryID
    from noc.inv.models.interface import Interface
    from noc.sa.models.managedobject import ManagedObject

    logger = logging.getLogger()

    rx_hostname_default = re.compile(r"(?P<hostname>\S+)")


    def handler(o: ManagedObject, iface: Interface):
        logger.debug("Linking o %s, iface: %s" % (o, iface))
        rx_hostname = iface.profile.ifdesc_patterns or rx_hostname_default
        match = rx_hostname.search(iface.description)
        if match:
            # Find remote object by hostname
            rdid = DiscoveryID.objects.filter(hostname__icontains=match.group("hostname")).first()
            if not rdid:
                logger.warning("Not find remote object by hostname: %s", match.group("hostname"))
                logger.info("Not find remote_object")
                return None
            # Find local hostname on DiscoveryID
            ldid = DiscoveryID.objects.get(object=o.id)
            if not ldid.hostname:
                logger.info("Not find hostname for local Object")
                return None
            # Find RemoteInterface by description
            ri = Interface.objects.filter(
                managed_object=rdid.object, description__icontains=ldid.hostname
            ).first()
            if ri:
                return ri
            logger.info("Not find interface")
        return None