troubleshooting

Diagnose and fix common Cartography intel-module errors.

4.0k|550|Updated Feb 27, 2019
One-click install
npx skills add https://github.com/cartography-cncf/cartography --skill troubleshooting-cartography-cncf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooting
Source: https://github.com/cartography-cncf/cartography/tree/main/.agents/skills/troubleshooting
Command: npx skills add https://github.com/cartography-cncf/cartography --skill troubleshooting-cartography-cncf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix common Cartography intel-module errors — ModuleNotFoundError, PropertyRef validation failed, GraphJob failed, missing relationships, MatchLink misses, cleanup deleting too much, slow queries, ignored custom schema fields, key errors during transform.

Core Features & Use Cases

  • Diagnostic playbook for the most common errors encountered while developing Cartography intel modules.
  • Step-by-step guidance for import errors, schema validation, relationship connections, cleanup failures, data transform issues, and performance problems.
  • Debugging tips and checks to quickly identify root causes and apply fixes.

Quick Start

Consult this guide whenever you encounter Cartography intel-module errors to quickly identify and fix root causes.

Frequently Asked Questions about troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my Cartography intel module throw a ModuleNotFoundError during import?

Cartography intel module ModuleNotFoundError typically occurs when the module directory is missing an __init__.py file. Adding this empty initialization file ensures Python recognizes the directory as an importable package.

How do I fix PropertyRef validation failed errors in Cartography schema definitions?

PropertyRef validation failed in Cartography indicates incorrect PropertyRef usage within your schema. Verify that all property references match the expected data types and schema definitions to resolve the validation failure.

What causes missing relationships or MatchLink misses in Cartography graph syncs?

Missing relationships and MatchLink misses in Cartography usually stem from misnamed relationships in your intel module. Ensure relationship labels and target node properties exactly match the core Cartography schema.

How do I stop Cartography cleanup jobs from deleting too much graph data?

Cartography cleanup deleting too much data happens when cleanup parameters are overly broad. Adjust the GraphJob cleanup logic to accurately scope node and relationship deletion based on specific intel-module identifiers.

Why does my Cartography intel module ignore custom schema fields during transform?

Cartography ignoring custom schema fields during transform happens when fields are not properly declared. Ensure all custom properties are explicitly defined in the schema and mapped correctly during the data transform step.

How do I troubleshoot slow queries and key errors in Cartography intel modules?

To troubleshoot slow queries and key errors in Cartography intel modules, review data transform logic for missing dictionary keys and optimize graph query patterns to improve performance during relationship syncs.