This document describes how to take advantage of the intelligence provided by Developer Connect insights insights.
Before you begin
Before you can use Developer Connect insights, you need to follow the steps in Set up Developer Connect insights. The roles and permissions needed for Developer Connect insights are described in that article.
Use Developer Connect insights in Gemini Cloud Assist
You can use Gemini Cloud Assist to see the insights generated by Developer Connect insights.
When an investigation is created in Gemini Cloud Assist, the system automatically picks up deployments relevant to your App Hub application. When making diagnoses, Gemini Cloud Assist uses these deployments as context.
When Gemini Cloud Assist correlates a deployment event with your
investigation, the system displays a card titled "Deployment
of [DEPLOYMENT_NAME]."
Click Correlated Events on the cards to open the relevant logs in Logs Explorer.
When Gemini Cloud Assist believes that a specific deployment is causing an error, it includes that deployment as one of the hypotheses, with title "Recent Deployment Impacting Application Behavior," along with recommendations for remediation.
View Developer Connect insights log entries
Because the insights created using Developer Connect insights are stored as log entries in
Cloud Logging, you can view deployment metadata in Logging. To
view log entries created by Developer Connect insights, use the gcloud logging read
command, filtering by log name, as follows:
gcloud logging read logName=projects/PROJECT_ID/logs/developerconnect.googleapis.com/sdlc-deployment` \
--project=PROJECT_ID
In this command, replace PROJECT_ID with the ID of the project in which you created your Developer Connect insights config.
This command returns logs with the name sdlc-deployment, but you can also
filter by other values, for example, your Developer Connect insights config ID
(labels.insights_config_id=) to show log entries for a specific insights
config.
The following is a sample of a JSON log entry produced by Developer Connect insights:
{
"insertId": "11h69plf2713tb",
"jsonPayload": {
"previousDeployment": {
"resource": "//container.googleapis.com/projects/P/locations/L/clusters/dci-cluster",
"deploymentId": "//container.googleapis.com/projects/P/locations/L/clusters/dci-cluster/k8s/namespaces/default/apps/replicasets/dci-test-app-c8cf94d46",
"artifactDetails": [
{
"commitReferences": [
{
"commitSha": "5460433ebfc4b2a7602e21f90828559b4891943e",
"commitUrl": "https://github.com/USER/REPO/commit/5460433ebfc4b2a7602e21f90828559b4891943e"
}
],
"packages": [
{
"packageVersion": "3.40.1-2+deb12u1",
"packageName": "libsqlite3-0"
},
{
"packageVersion": "0.45.1",
"packageName": "wheel"
},
],
"artifactUri": "us-central1-docker.pkg.dev/P/R/dci-test-app-image@sha256:86ee1874886beb7d2042e40e3ff7253a974c579d49dbbfbba576aad13c880709"
}
],
"statusSummary": "1/1 Running",
"timestamp": "2025-03-21T21:13:28Z"
},
"currentDeployment": {
"resource": "//container.googleapis.com/projects/P/locations/L/clusters/dci-cluster",
"statusSummary": "5/5 Running",
"artifactDetails": [
{
"packages": [
{
"packageVersion": "3.40.1-2+deb12u1",
"packageName": "libsqlite3-0"
},
{
"packageVersion": "0.45.1",
"packageName": "wheel"
},
],
"artifactUri": "us-central1-docker.pkg.dev/P/R/dci-test-app-image@sha256:86ee1874886beb7d2042e40e3ff7253a974c579d49dbbfbba576aad13c880709",
"commitReferences": [
{
"commitUrl": "https://github.com/USER/REPO/commit/5460433ebfc4b2a7602e21f90828559b4891943e",
"commitSha": "5460433ebfc4b2a7602e21f90828559b4891943e"
}
]
},
{
"artifactUri": "us-central1-docker.pkg.dev/P/R/dci-test-app-image@sha256:86ee1874886beb7d2042e40e3ff7253a974c579d49dbbfbba576aad13c880709",
"packages": [
{
"packageVersion": "3.40.1-2+deb12u1",
"packageName": "libsqlite3-0"
},
{
"packageVersion": "0.45.1",
"packageName": "wheel"
},
],
"commitReferences": [
{
"commitSha": "5460433ebfc4b2a7602e21f90828559b4891943e",
"commitUrl": "https://github.com/USER/REPO/commit/5460433ebfc4b2a7602e21f90828559b4891943e"
}
]
}
],
"deploymentId": "//container.googleapis.com/projects/P/locations/L/clusters/dci-cluster/k8s/namespaces/default/apps/replicasets/recommendation-app-c8cf94d46",
"timestamp": "2025-03-21T21:16:33Z"
}
},
"resource": {
"type": "k8s_cluster",
"labels": {
"location": "us-central1",
"project_id": "REDACTED",
"cluster_name": "REDACTED"
}
},
"timestamp": "2025-03-21T21:16:33Z",
"severity": "INFO",
"labels": {
"insights_config_id": "projects/P/locations/L/insightsConfigs/ecommerce-699",
"insights_config_deployment_id": "projects/P/locations/L/insightsConfigs/ecommerce-699/deployments/ee54cbae-08f4-4970-a61b-bc28740572c7"
},
"logName": "projects/P/logs/developerconnect.googleapis.com%2Fsdlc-deployment",
"receiveTimestamp": "2025-03-21T21:18:01.154658625Z",
"apphub": {
"application": {
"container": "projects/dci-test-project-3",
"location": "us-central1",
"id": "dci-test-app"
},
"workload": {
"id": "dci-test-app",
"environmentType": "PRODUCTION",
"criticalityType": "MISSION_CRITICAL"
}
}
}
What's next
- Learn more about Gemini Cloud Assist investigations