neuron-nki-profile-querying

Analyzes AWS Neuron kernel profiles via SQL and Python operations.

50|4|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/aws-neuron/neuron-agentic-development --skill neuron-nki-profile-querying
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neuron-nki-profile-querying
Source: https://github.com/aws-neuron/neuron-agentic-development/tree/main/skills/neuron-nki-profile-querying
Command: npx skills add https://github.com/aws-neuron/neuron-agentic-development --skill neuron-nki-profile-querying

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill enables users to query and analyze detailed kernel execution profiles on AWS Neuron hardware, facilitating performance diagnostics and optimization.

Core Features & Use Cases

  • Profile Data Querying: Run SQL or Python scripts to extract insights from profile tables such as instruction timing, engine utilization, and memory transfers.
  • Performance Bounds Calculation: Compute theoretical memory and compute bounds to identify bottlenecks.
  • Investigation of Inefficiencies: Trace and localize runtime inefficiencies like redundant data transfers, idle engine time, or transposes for targeted improvements.
  • Use Case: A researcher wants to analyze how a neural network kernel utilizes the Tensor Engine and identify if data movement is limiting performance before re-implementing the kernel.

Quick Start

Run the neuron-explorer view command to ingest an existing profile, then use curl requests to retrieve summary, instruction structure, and schema information, all in a straightforward pipeline for performance analysis.

Frequently Asked Questions about neuron-nki-profile-querying

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

FAQPage Schema
How do I query AWS Neuron kernel profiles to identify performance bottlenecks?

You can query AWS Neuron kernel profiles using SQL or Python scripts to analyze instruction timing, engine utilization, and memory transfers, which helps identify specific performance bottlenecks. This requires existing profile data and the neuron-explorer tool for in-depth diagnostics.

Can I calculate compute and memory bounds for Neuron kernel execution?

Yes, you can calculate theoretical memory and compute bounds for Neuron kernel execution. By computing these bounds, you can determine whether data movement or compute operations are limiting performance before re-implementing your kernel.

What do I need to analyze Neuron hardware profiles for optimization?

To analyze Neuron hardware profiles, you need existing profile data, NEFF and NTFF files, and the neuron-explorer tool. You ingest the profile using the neuron-explorer view command, then use curl requests to retrieve summary and schema information.

How do I trace runtime inefficiencies like redundant data transfers in Neuron kernels?

You can trace and localize runtime inefficiencies such as redundant data transfers, idle engine time, or transposes by querying detailed profile tables. This allows you to pinpoint specific instructions or memory operations causing inefficiencies for targeted improvements.

What's the best way to analyze Tensor Engine utilization for a neural network kernel on Neuron?

The best way to analyze Tensor Engine utilization is by querying kernel execution profiles to extract engine utilization metrics. This reveals how effectively your neural network kernel uses the Tensor Engine and highlights if data movement is limiting performance.